CD ROM Paradise Collection 4/CD ROM Paradise Collection 4 1995 Nov.iso/os2/zoc205.zip/INSTALL.FIL/ZOC.HLP

OS/2 Help File | 1995-02-22 | 111KB | 3,441 lines

ΓòÉΓòÉΓòÉ 1. Getting Started ΓòÉΓòÉΓòÉ

 Before using ZOC you should browse through one of the following help topics
(according to your datacom knowledge).

                             Novice (new to datacom)
                            Experienced (new to ZOC)
                           Experienced (ZOC V1.x User)

If you have questions about ordering ZOC, see General Info.

Display of this window at startup time can be turned off in the
Options->Settings->Window menu.


ΓòÉΓòÉΓòÉ 1.1. Help for Datacom Novices ΓòÉΓòÉΓòÉ

 If you never used a datacom program, it is highly recommended to order and
read the printed documentation for ZOC. It contains a guide to datacom and
explains a lot of the technical terms in the first part (user guide). You
should work through the tutorial there.

If you don't have a printed manual (it can be ordered from the
distribution/registration sites), you could print the help file (from the help
window's print button). Proceed as described in the topic for Experienced Users
but make sure you read the according help topics carefully.

After you made your first call, you should make yourself familiar with other
ZOC functions and options. You will find many new things that seem of no use at
first sight, but if you read about them you will remember them later when they
come in handy.

The help file contains a complete Menu Function and Options reference. Showing
the Contents of the help file might be useful as well.


ΓòÉΓòÉΓòÉ 1.2. Experienced Users (new to ZOC) ΓòÉΓòÉΓòÉ

 If you never used ZOC before, you should proceed as follows:

 1.
    First, read the help topic about the Screen Elements. Don't miss the
    section about the main window (about clipping text with the mouse).

 2.
    Then, customize the options in the modem section (make sure you read the
    help pages there, ZOC does some things in a slightly different way from
    other programs) and make sure you use a modem init string you already used
    successfully in another comm program (don't forget to append ^M to it).
    Then set the serial parameters (checking the settings from your other comm
    program might help a lot) and customize your window.

    Then save the options to disk.

 3.
    Next, you should open the phone book and create a new entry for your
    favorite bbs or host. Don't miss the help topic for the AutoLogin feature
    (at present it is unique to ZOC and can make things a LOT easier).
    Everything else is more or less similar to other comm programs.

    Before calling it, you should set the options for the phone book (use the
    Options button in the main window of the phone book, or phone book options
    from the Options->Global Menu).

 4.
    Make a call and check if everything works. If not, try to find the problem
    (compare your settings with those of the comm program that worked for you
    so far).

 5.
    If everything works you should make yourself familiar with other ZOC
    functions and options. You will find many that are similar to the comm
    program you already used, but there will be a lot of new things as well.

    The help file contains a complete Menu Function and Options reference.
    Showing the Contents of the help file might be useful as well.


ΓòÉΓòÉΓòÉ 1.3. Version Shock (ZOC V1.x -> V2.x) ΓòÉΓòÉΓòÉ

 If you have already used ZOC V1.x, you will very likely be pleased about the
improvements since V1.33 (unless you are a real purist and don't like new
features).

But no progress comes free, so there are a few things that had to be changed in
order to maintain a logical user interface or for technical reasons.

Here is a list of things that you should be aware of or that you might miss
when browsing through the menus and options (obviously new things are not
listed).

o The options are now split into Global Options and Options Sets. Most of the
  Global Options are new, but the Directories and the Phone Cost Manager were
  moved out of the options booklet.

o The phone cost calculation was completely redesigned, the install program
  does not convert your existing phone cost setup.

o The screen marking of blocks (formerly with the right mouse button) was
  changed to Alt+left mouse button.

o The right mouse button now brings up menus in the phone book, in the main
  window and in the status line.

o The right mouse button now brings up the setup dialogs in the toolbar and in
  the button bar.

o A find command was added to the capture browse window (press 'F').

o The call log file now logs file transfers.

o Modem init and dial strings now require a ^M at the end (this should work
  automatically).

o Ctrl+Space now sends ^@

o There is a setup for multimedia files in the directory options.


ΓòÉΓòÉΓòÉ 1.4. Starting ZOC (command line parameters and environment variables) ΓòÉΓòÉΓòÉ

 Command Line Parameters

There are some parameters that can be specified when starting ZOC from the
commandline or from an icon.

ZOC [/C] [/M] [/O:<options file>] [/P:<host name>] [/Q] [/S:<scriptfile>] [/U]

     /C
    This option specifies that you want ZOC to open the COM port in shared
    (cooperative) mode. This way other programs can access the COM port
    together with ZOC (but only if they open it in shared mode as well, which
    OS/2-MDOS and WINOS2 programs don't).

     /M
    This option specifies that you want to start ZOC with its windows
    minimized.

     /O
    With this option, you can tell ZOC to load an options file at start time
    (normally OPTIONS\STANDARD is used). This can be useful if you have more
    than one modem and different setups for these. A path should be specified,
    e.g. ZOC /O:OPTIONS\COM2OPTS

     /P
    This is a name of a host from the phone book to be called after startup.

     /Q
    This option suppresses the introduction window while loading ZOC.

     /S
    With this option, you can tell ZOC to process a REXX program or a
    scriptfile after start. A path can be specified, e.g. ZOC
    /S:SCRIPT\NIGHTCALL.

     /U
    This option specifies unattended mode. In unattended mode ZOC opens no
    requesters (like 'Are you sure') but answers them with their default
    setting automatically. This way the program won't hang if you run it in the
    middle of the night to fetch your mail and something unforeseen happens.

 Environment Variables

ZOC uses the TZ environment variable to correct the file date transmitted by
Zmodem.

Zmodem was developed with Unix in mind, where time stamps (file date/time) are
always stored in Greenwich time and where local time is calculated by the dir
command.  This way a file always carries the correct local time, even if
shipped on disk around the globe.  However, the OS/2 file system knows nothing
about the time zones which are still part of Zmodem. Most OS/2 or MS-DOS
systems emulate the time zone in one way or anothor, mostly using Eastern
Standard Time (5 hours west of Greenwich) by default; files received from such
senders get the correct time when received by ZOC. However, some hosts use
other time zones. If you want to adapt your time zone setting to such hosts,
you should add the TZ environment variable to your CONFIG.SYS.

To do this use SET TZ=<SSS><N><DDD> where <SSS> is a 3-char standard time code,
<N> is the time difference from Greenwich and <DDD> is a 3-char daylight saving
time code, eg. use SET TZ=EST5EDT for Eastern Standard Time (which is the
default) or TZ=CET2CDT for Central European Time.

 Startup REXX Programs There are two REXX programs that are started when you
run ZOC. The first one is SCRIPT\ZOCEVENT.CMD (it's also run when ZOC closes)
and it is intended to stop or restart a fax program's (eg. FaxWorks) auto
receive feature.  See the comments in ZOCEVENT.CMD for more details.

The other REXX program is called STARTUP and is run after ZOC has been
initialized.  You can use it to call a BBS every time you start ZOC or things
like that.


ΓòÉΓòÉΓòÉ 1.5. Screen Elements ΓòÉΓòÉΓòÉ

The elements of the screen are:

o Menu

o Toolbar

o Custom Button Bar

o Main Window

o Chat Field

o Status line


ΓòÉΓòÉΓòÉ 1.5.1. Menu ΓòÉΓòÉΓòÉ

 The menu lets you select most of the ZOC functions (for a description of the
particular functions see Menu Overview).


ΓòÉΓòÉΓòÉ 1.5.2. Toolbar ΓòÉΓòÉΓòÉ

 The toolbar offers icons for most of the functions in ZOC.

You will see a description for each icon, if you move the mouse over it and
wait half a second.

You can Customize the Toolbar from the Options Menu or by clicking with the
right mouse button on the toolbar.


ΓòÉΓòÉΓòÉ 1.5.3. Custom Button Bar ΓòÉΓòÉΓòÉ

 The custom button bar is located beneath the toolbar and offers buttons that
can be defined in Button Options of the Options Menu to start REXX programs or
send text.


ΓòÉΓòÉΓòÉ 1.5.4. Main Window ΓòÉΓòÉΓòÉ

 The main window displays the received text.

You can bring up a popup menu by clicking the right mouse over the main window.

You can mark text with the left mousebutton (this is called stream mode).

If you hold the Alt key pressed while marking text, the selection will be made
in block mode rather than in stream mode (block mode lets you select arbitrary
rectangular areas on the screen, stream mode is line orientated).

If you hold the Ctrl key pressed while doing the selection, the text will be
appended to the text that already is in the clipboard rather than overwriting
it.

The marked text is copied into the clipboard and can be accessed from the
functions Send, Send without CRs, Send quoted, Send CIS-quoted, Print and Edit
in the Cliptext Menu and with some key shortcuts.


ΓòÉΓòÉΓòÉ 1.5.5. Chat Field ΓòÉΓòÉΓòÉ

 The chat field is an entry field into which you can enter text. The text is
not sent until you press enter. This is helpful if you are in an online
conference or if you use a remote shell that does not provide command editing
and history.

The chat field can be activated from Window Options or by pressing Alt+C or by
pressing the Scroll-Lock key (the latter, only if defined accordingly in
Terminal Options).

If the cursor is in the chat field, you can discard it by pressing ESC, Alt+C
or the Scroll-Lock key.

You can use arrow keys to retrieve the last few lines you typed (this works
like the command history in an OS/2 shell).


ΓòÉΓòÉΓòÉ 1.5.6. Status Line ΓòÉΓòÉΓòÉ

 The status line provides information about and access to some options (if your
ZOC window is not wide enough (because of a small font) some of the information
will not be available).

Using the right mouse button in the status line brings up a popup menu that
gives access to all options dialogs.

 Serial Parameters
    This button displays the currently set line speed and parameters. Clicking
    on the field with the left mouse button brings up the Serial Options
    dialog.

 Transfer Protocol
    This button displays the currently set file transfer protocol. Clicking on
    the field brings up the Transfer Options dialog.

 Emulation
    This button displays the current terminal emulation. Clicking on the button
    brings up the Emulation Options dialog

 Timer
    This button displays the timer. The value depends on the currently set mode
    (see Cost Description and Window Options).

    A lowercase letter a-h means that a timer unit is selected and that the
    timer was stopped. A capital letter indicates that the timer is running. A
    number (n) after the letter indicates that the n-th time section for the
    distance zone is currently used.

    A click on the button brings up the Timer Options dialog.

 LEDs
    The four LEDs in the status line provide two services:

    If they turn green, your host has requested the VT102 LED service and sets
    the LEDs according to the application you run. The LEDs will stay green
    until you change the emulation or clear the screen from the Misc Menu.

    If they are red they display additional status information:

    LED 1
       ON: Modem Carrier Detect

       OFF: No Carrier.

    LED 2
       Bright Red: Script running.

       Blue: Doorway mode active.

       Pink: Autologin running.

    LED 3/4
       Modem receive-data and send-data. They can be turned off in the Window
       Options.

 Logfile
    This checkmark displays the name of the logfile and opens or closes it.

 Online Time
    This shows how long you are (or have been) connected to a host.

 Window Size
    This shows the size of the window (columns x rows).


ΓòÉΓòÉΓòÉ 2. Menu Overview ΓòÉΓòÉΓòÉ

 The menu provides seven submenus which give you access to ZOC's functions:

o MODEM

o LOGGING

o CLIPTEXT

o TRANSFER

o MISC

o OPTIONS


ΓòÉΓòÉΓòÉ 2.1. Modem Menu ΓòÉΓòÉΓòÉ

 The modem menu manages all necessary functions to maintain the modem and to
connect to a host.

 Initialize
    This function sends the init string defined in the Modem Options to the
    modem to set it to a defined state. It will do this regardless of the
    current carrier detect state.

 Manual Dial
    This function opens a window to enter a phone number. This number is then
    dialed using the dial string (see Modem Options) you specify in the window
    as well. If the number is busy or cannot be reached for any reason, ZOC
    will redial it using the options specified in the Phone Book Options.

 Hangup
    Disconnects the line using the hangup method defined in Modem Options.

 Send Break
    Pulls the data pin of the modem low for a given time (see Modem Options).
    This is called 'sending a break'. Some systems use this to stop the current
    operation.

 Auto Answer
    This function enables/disables the auto answer mode of your modem using the
    commands you set up in Modem Options. In auto answer mode the modem will
    automatically pick up the phone when the phone rings and will try to
    establish a data connection with the calling modem (of course this is not a
    good idea when you expect voice calls).

 Phone book
    The phone book is a dialog to maintain your personal dialing directory or
    to connect to one or more numbers from it (see Phone Book).

 Call next
    If you select more than one host to call in the phone book, ZOC connects to
    the first of them that is available. After finishing the call you can
    select this function to try to reach the next available host.

 Call XXXX
    At the end of the modem menu appear those entries from the phone book that
    have the Menu Access option enabled (see Changing Phone Book Entries). This
    is handy for hosts you call often.


ΓòÉΓòÉΓòÉ 2.2. Logging Menu ΓòÉΓòÉΓòÉ

 ZOC maintains four different logging methods. One is logging to a memory
buffer, (called Capture) so you can review data that scrolled off the screen
during a session. Another is the logfile that logs all incoming data
permanently to a file on the hard disk. Yet another is redirecting all incoming
data directly to the printer. The last one, the call log, logs time, duration,
cost and file transfers of your calls to a file (see Call Log).

The Logging Menu controls the capture, logfile and printer logging.

 Browse Capture
    This function shows the contents of the capture (for more information see
    Browse Window).

 Clear Capture
    Clears the capture buffer. This function is affected by the Safety Options.

 Load Capture
    Loads a file from disk to the end of the capture buffer.

 Edit Capture
    Starts the editor defined in Directories with the contents of the capture
    buffer. After you leave the editor, the modified contents will be moved
    back into capture buffer.

    Note:  This functions closes the browse window if it is open.

 Print Capture
    Sends the entire contents of the view buffer to the printer (also available
    from the Toolbar). Of course this can result in a lot of printing.

 Set Log Name
    Set the name of the current logfile. The name can be automatically selected
    from the phone book when connecting to a host (when starting ZOC the
    logfile gets its name from Capture Options). You may use special
    placeholders for the name as described in the Capture Options and the Code
    Section of the appendix.

 Default Log Name
    This sets the logfile to the file defined in Capture Options.

 Log active
    This function changes the toggles the status of logging between on and off.
    This can also be achieved by clicking on the capture name in the Status
    Line and can be done remotely if your host supports the DC2/DC4 logging
    protocol (see Capture Options).

 Delete Log Files
    Since you can build log file names that contain the current date you might
    end up with a lot of log files. Using this function lets you delete
    logfiles you do not need any more.

 Log to printer
    Sometimes it is handy to have part of a session sent to the printer. This
    is possible by enabling this function before receiving the data (e.g.
    before reading a mail).

    Additionally it is possible to print already received text, by opening the
    capture window (see Logging Menu), marking the text with the mouse (to copy
    it to the clipboard). and printing the contents of the clipboard from the
    Cliptext Menu.


ΓòÉΓòÉΓòÉ 2.3. Cliptext Menu ΓòÉΓòÉΓòÉ

 Cliptext is text that is stored in the clipboard of the WPS. Normally it is
copied from a ZOC screen by marking characters with the left mouse button (this
can be combined with the Alt key), but it can be copied or cut from an editor
or any other program as well.

 Mark
    This function is just an info message of how to put text from screen into
    the clipboard.

 Copy Window
    This function copies the entire contents of the ZOC text window into the
    clipboard.

 Send
    This function takes text from the clipboard and sends it to the modem. The
    sending is done like an ascii upload and the delay and CR/LF translation
    from Ascii Upload Options are used.

 Send (no CRs)
    Takes text from the clipboard and sends it to the modem. Carriage Returns
    are ignored and a Space is sent instead. This function is affected by the
    Ascii Options in the Transfer Options window.

    Imagine the following case: You searched a host for files with the keyword
    TERM and the host gave you a list of filenames - one in each line. To
    download all files, you could mark the list with a box (left mouse button
    while pressing the Alt key) and send them with a space between them when
    the host asks for the filenames to download.

 Send quoted
    Text from the clipboard is sent. Each line is preceded by > to indicate a
    quotation. If you press the shift key while selecting this function, ZOC
    will reformat the text to fit into the line before sending it. The function
    is also available from the Toolbar and is affected by the Ascii Upload
    Options in the Transfer Options window and 'Quote always smart' in the
    Terminal Options window.

    Note:  If you hold the shift key pressed while selecting this function, the
    text will be reformatted to fit a given width.

 Send CIS-quoted
    The quoting style of the Send Quoted function is used widely across the
    networks. However, on CompuServe most people quote text by starting the
    quotation with >> and ending it with <<.

    This function works the same as Send Quoted but uses the CompuServe
    quotation style.

    Note:  If you hold the shift key pressed while selecting this function, the
    text will be reformatted to fit a given width.

 Edit
    Calls the system editor (see Directory Options) with the contents of the
    clipboard. After saving, the new contents is written back into the
    clipboard.

 Print
    Sends the contents of the clipboard to the printer (the printer port is
    defined in Directory Options).


ΓòÉΓòÉΓòÉ 2.4. Transfer Menu ΓòÉΓòÉΓòÉ

 The transfer menu allows you to send files to the host or receive them from
it.

 Upload
    Sending a file to a host is called an Upload. To do this the sender and
    receiver use certain methods called Transfer Protocols. The upload function
    sends a file to the host using the currently active protocol (see Transfer
    Options).

 Download
    Receiving a binary file from a host is called a Download. The same transfer
    protocols are used as for uploads. Downloads are affected by the Transfer
    Options.

 ASCII Send
    This functions takes text from a file and sends it to the modem without
    using a file transfer protocol. Roughly spoken, an ascii upload is the same
    as typing text very fast. This way you can prepare messages using an editor
    before you call a host and then send the file with this function when the
    host asks you to type your message.

    Note:  If the host loses characters in this process, you can specify a
    delay for each character in the Transfer Options window.

 Plugs
    This function gives access to add in modules (so called Plug-In-Protocols)
    and lets you do Setup, Upload or Download for them. Plug-In-Protocols are
    provided from third party and are stored in DLL files named PIP*.DLL.

    Currently there are PIPs available for Kermit and CompuServe-B file
    transfer.

    If no such modules exist in your ZOC directory, this function will be
    disabled.

 Transfer Shell
    Transfer shell launches a command processor from which you can start
    command line based external protocols that can accept a file handle for the
    com port. The handle of the communications port is given in the environment
    variable ZOCHFC.

    Example:

        CKERMIT -l %ZOCHFC% -r

    Transfer Shells are available from REXX programs (see REXX command list),
    F-Keys, User Buttons and AutoReplies as well (see Special Codes).  To start
    an external protocol like M2ZMODEM from a macro key, you would define it as

    Example:

        ^XFER=M2ZMODEM -u %ZOCHFC% -r .\DOWNLOADS

    If you map that onto an AutoReply (instead of F-Key) you could even have it
    starting automatically.

 Transfer DOS-Shell
    A transfer DOS-Shell lets you start a DOS command processor from which you
    could run external protocols.  This is a rather tricky feature, since DOS
    programs cannot share the COM port with OS/2 programs.  To run them anyway,
    ZOC has to release the COM device, which clears the DTR signal on the
    serial port, whereupon modems normally hang up.  To prevent this, ZOC has
    to send a special command string (see Modem Options) to make the modem
    ignore the DTR signal.

    Transfer DOS-Shells are available from REXX-programs (see REXX command
    list), F-Keys, User Buttons and AutoReplies as well (see Special Codes).
    To start an external DOS protocol like DSZ from a macro key, you would
    define it as

    Example:

        ^DOSXFER=\DOSCOMM\DSZ\DSZ port 1 rb

    Note:  However, if possible, you should use OS/2 protocols (like CKERMIT, P
    or M2ZMODEM) since DOS communication protocols eat a LOT of CPU power when
    running under OS/2.


ΓòÉΓòÉΓòÉ 2.5. Misc Menu ΓòÉΓòÉΓòÉ

 Start REXX
    Starts a REXX program (or script). REXX is something like a batch programs
    for ZOC, which lets you process specific tasks automatically (see ZOC
    Automation).

 Stop REXX
    Stops a currently running REXX.

 Edit REXX
    Call the editor to modify a script file manually.

 Learn REXX
    Most of the time REXX is used automate logins. Writing these is a rather
    tedious and boring task that can, for the most part, be done automatically.
    If you select this function before calling a host, ZOC will monitor the
    login process and create a REXX program that handles the login
    automatically.

    Note:  The program will only contain the code necessary for the log in. It
    will not contain commands to call that host (which is normally done from
    the phone book and not from script).

 Stop Learning
    After you enabled script learning and logged into a host you tell ZOC to
    stop the learning process. ZOC will ask you for a name and store the script
    accordingly. The name you use can be entered into the REXX field of a phone
    book entry (see Changing Phone Book Entries). and ZOC will execute it to
    log you into that host after making a connection.

 Lock Macros
    Lock the macro keys to prevent unauthorized use.

 Unlock Macros
    Unlock the macro keys again. If defined, the password from Safety Options
    is required.

 Reset Timer
    Reset the timer in the status line which displays the time or cost of your
    current call.

 Hold Timer
    Stop the timer in the status line which displays the time or cost of your
    current call.

 Release Timer
    Restart the timer in the status line which displays the time or cost of
    your current call.

 Set Timer
    Set the timer to a specific value.

 Split Chat
    The split chat function splits the screen horizontally and shows text you
    type in the lower half while displaying text you receive in the upper. This
    is handy if you want to chat with someone who called you by modem.

    Note:  You should not use this function while accessing a remote host.

 Clear Screen
    This functions just clears the terminal screen and resets the LEDs in the
    Status Line back to red.

 Snippets
    ZOC monitors your input data stream for filenames, fido node numbers,
    CompuServe user IDs and Internet addresses and collects them in a little
    window that floats aside the ZOC window. Using this function you can show
    or hide the Snippets Window. When it is showing, you can send one of the
    collected items by double clicking it with the mouse.

    Note:  This feature needs a bit of CPU power, so if you don't need it or
    don't have fast machine you should disable it in the Window Options. A good
    compromise is to hide the window most of the time (thus monitoring the
    input stream but saving the CPU power to update the window) and to show it
    (using the Alt+. key combination) when it is needed.

    Note:  You can change the font of the Snippets window by dragging a font
    from the System->Setup->Fonts folder of the WPS and dropping it above the
    Snippets window.

 Editor
    Call the editor defined in the Directory Options.

 OS/2 Shell
    Call the shell defined in the Directory Options.


ΓòÉΓòÉΓòÉ 2.6. Options Menu ΓòÉΓòÉΓòÉ

 The options menu is used to define the characteristics of ZOC.

There are basically two kinds of options: global options and option sets.

The global options (like directory or sound file names) remain the same for all
the hosts you call, while options from the options sets (like the settings of
the macro keys or character translation) will very likely change from host to
host. Different option sets can be stored in files an can be retrieved when
calling a host. There is one special option set named STANDARD which is used
when you start ZOC.

 Global
    Display a submenu to jump to one of the global option definition dialogs
    (see Global Options).

 Settings
    Opens a settings notebook to define all kind of options (see Options
    Notebook).

 Jump to
    Display a submenu to jump to a specific page in the options booklet.

 Save
    Save the current set of options to disk.

 Save As
    Save an options set in a file with a different name. If saved as STANDARD,
    it will be loaded automatically when ZOC is started.

 Load
    Load a set of options.

 Reset
    Reset the current options set to the default state.


ΓòÉΓòÉΓòÉ 3. Phone Book ΓòÉΓòÉΓòÉ

 Select How to use the phone book or Changing a phone book entry.


ΓòÉΓòÉΓòÉ 3.1. How to use the phone book ΓòÉΓòÉΓòÉ

 The phone book acts as a personal dial directory for numbers you call with
your modem.

It is subdivided into four sections (default, 1st, 2nd and 3rd alternate) which
means, that you practically have four different phone books.

The main window lets you select one or more hosts to call and gives you
functions like Delete or Edit that are necessary to maintain the list.

 Dial
    Connects to one or more selected entries. If you select more than one entry
    (to do this, hold the Ctrl key pressed while you click on one entry after
    the other with the mouse) ZOC will connect to the first that is available
    and store the others in an internal dial queue so you can call them later
    (using the Call Next operation from the Modem Menu).

 Delete
    Deletes one or more entries from phone book.

 Edit
    Changes the data of the selected entry (check Changing a Phone Book Entry
    for details).

 New
    Creates and edit a new entry in this section of the phone book.

 Clone
    Creates and copy of the selected entry and opens the edit window.

 Due
    Selects all entries which are due for calling (marked with a little yellow
    flash in front of the phone number). ZOC determines the entries that are
    due for calling by looking at the date of the last call and the 'Call after
    xx days' field from the edit window.

 Print
    Prints the selected entries.

 Default Book/#1/#2/#3/All
    These buttons show the selected section of the phone book.

 Options
    Show the phone book options (this is the same as calling the phone book
    options from the options menu).


ΓòÉΓòÉΓòÉ 3.2. Changing a phone book entry ΓòÉΓòÉΓòÉ

 Name
    A name for the entry. For multi port hosts, you should use names that are
    equal in the first six characters (e.g. AVALON-1, AVALON-2 ...). This ZOC
    will maintain call dates and the like for all ports of the host instead of
    updating only the one that was called.

 Phone number
    The phone number of the host.

 Call every XX days
    If ZOC finds a carrier detect signal after calling a host, it will update
    the date of last call for the called entries (and all others that are equal
    to the one that was called in the first six characters of the name, thus
    managing multi-line hosts correctly, see above).

    If you want to call a host regularly (say once a week) you can enter the
    number of days here after which ZOC should remind you (by showing a symbol
    in front of the phone number in the main window) that it is time to call
    that host again.

 Phone book
    Select the phone book section to store this entry to.

 Sort first
    The phone book is sorted according to the Phone Book Options but you might
    have entries that you want on top of the list regardless of their name,
    last call or whatever it is you use to sort the list. This option will send
    the entry to the top of the list.

 Menu access
    Select this if you want the host to be accessible from the modem menu.
    Insert a tilde before a character in the name (e.g. ~ZOC InfoBBS), to
    create a shortcut for the menu item.

 Group call
    If you call hosts that have multiple phone numbers you should create one
    entry for each phone number and name them in a way that the first six
    characters of the entries are the same (see above).

    If you don't want to select all these entries to call that host you should
    enable the group call option for one (or all) of them. This way ZOC tries
    the other lines as well to connect to the host.

 Options file
    Enter the name of an options file to be loaded before setting the serial
    parameters, the emulation and filetransfer the protocol. The option file
    must be preceded by a path (e.g. OPTIONS\COMPUSRV.OPT).

    This way you can have entirely different options for different hosts.

 Serial parameters
    Serial parameters to be set before calling the number (e.g. 19200-8N1).

    If you leave this field blank, the current setting or the setting from a
    loaded options file will be used.

    You may leave out the options (and just type a line speed).

    If you just want to set the options and leave the current line speed
    unchanged set the speed to zero (e.g. 0-7N1).

 Emulation
    Select an emulation to use after loading the options file but before
    calling the host.

 Protocol
    Select a protocol to set after loading the options file but before calling
    the host.

 Logfile
    This is a name to be used for logging the session. Special placeholders
    (for date or time) can be used as described in Capture Options.

 Dl. Path
    This is the name into which downloaded files are stored. This setting
    overwrites the value in Options->Global->Directories (which is restored at
    the end of the session only, if 'Load standard options after disconnect' is
    enabled in Dialling Options).

 REXX File and Arg
    The name of a REXX (or Script) file to be executed after the dialer has
    made a connection to the given phone number (for REXX programs the argument
    will be supplied in ARG(1)).

    Such a script could be used to log you into the host automatically.
    However, for simple login procedures (like sending user name and password),
    the AutoLogin feature or IEMSI (both described below) are more handy.

    Note:  IEMSI is only available if you enter a password.

 Prefix
    Select a dial command (from the Modem Options) to be used to dial the phone
    number.

 Cost
    If you set up the Phone Cost Description you can specify the distance zone
    to be used to calculate the phone cost for calls to this host.

 Password
    You can add a password for the host here. If you connect to the host you
    can send the password by defining a macro key as ^& (or by sending ^& from
    a REXX script).

    That is, if your F12 key is set to the text ^&, you can answer the password
    prompt of the host by pressing F12 (see Macro Keys).

    However, it is more convenient to let the AutoLogin feature (see below)
    handle the entire login.

 IEMSI
    Many bulletin board systems offer a method called IEMSI to automate the
    login procedure.

    Using this method you can provide your name in the IEMSI options window and
    set the password field to the password you use to log into that host.
    Additionally you can specify some options that are used by host.

    During the login the host will send and IEMSI request (**IEMSI_IRQ) to
    which ZOC responds by sending your user name and password to the host. If
    everything goes well, the host will let you in at once and show (or skip)
    news, new mail and new files as selected in the IEMSI options window.

    If you leave the name field empty, ZOC will use the name supplied in the
    Modem Options.

    Note:  This button is only available if you entered a password for this
    host.

 AutoLogin
    This field contains a sequence of events (either wait (W) or send (S)
    events) that logs you into the host automatically. Since most logins can be
    handled in a form like 'wait for this, then send that' ZOC offers a method
    to do exactly this without having to deal with REXX programming.

    To send special keys like Enter or ESC you can use control codes as
    described in the Appendix.

    S0=...
       If defined, S0 is sent unconditionally after a carrier signal was
       detected. It can be used to raise the attention of the host.

    Wn/Sn=...
       Define pairs of words to wait for and to reply then. Text to wait for is
       listed as W1, W2 ..., the corresponding text to be sent is given as S1,
       S2 ... (see example below).

    Note:
       the W and S characters must not be lowercase letters

    Example:


              W1=Esc|S1=^[|W2=Name|S2=Zaphod^M|W3=Password|S3=HeartOfGold^M
       This example means: To log in, first wait until the host sends the
       characters Esc, then send the ESC character to the host. After that wait
       until the host sends Name, and send Zaphod<Enter> back. Then wait for
       the text Password and send the text HeartOfGold<Enter>.

    Note:  You don't have to write such AutoLogin sequences yourself, since you
    can tell ZOC to learn it from watching you the next time you call this
    host.

 Memo
    This first line of the memo stores a short note about the host. You might
    want to enter the name of the sysop or other info about the host here (for
    passwords you should use the AutoLogin feature or the password field).

    If this field is not empty, it will be displayed in the phone book main
    window. If you don't like this, begin the memo with a space character; in
    this case, the main window will still show the number of calls instead of
    the memo.

    The other fields are maintained by ZOC and cannot be modified.


ΓòÉΓòÉΓòÉ 3.3. The AutoDial feature ΓòÉΓòÉΓòÉ

 When you selected one or more entries from the phone book or choose Manual
Dial from the Modem Menu the AutoDial window will pop up. It will try to
connect you successfully to the number(s) you selected. If a number is busy it
will try the next in the list (if more than one was selected) or retry the
number. To do that, AutoDial will use the values you set in Phone Book Options
to define the maximum number of retries and the time between attempts to call
the same number (see note about redial delay in Phone Book Options).

During AutoDial you can control the operation using four buttons:

 Cancel
    Abort calling.

 Redial Now
    If AutoDial waits to call the next number you can skip the delay and redial
    at once.

 Skip This
    This function skips the call to a number and proceeds with the next in the
    list. The skipped number will be called later.

 Forget This
    This function cancels the attempt to call a number and proceeds with the
    next in the list. The cancelled number will be removed from the dial list.


ΓòÉΓòÉΓòÉ 4. Other functions ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 4.1. Browse Window ΓòÉΓòÉΓòÉ

The browse window lets you scroll back through the text you received since
starting ZOC (or since clearing the capture buffer).

You can mark text with the mouse (thus putting it into the clipboard) or search
for text by pressing the F(ind) key.


ΓòÉΓòÉΓòÉ 4.2. File transfer window ΓòÉΓòÉΓòÉ

The transfer window consists of the following parts:

     Name
    The name of the file to be transferred (not available in Xmodem downloads).

     Size
    The size of the file to be transferred (not available in Xmodem downloads).

     Transmitted
    The number of bytes sent or received so far (the net value without control
    bytes like checksum).

     Time
    The duration of the transfer so far and the projected time to go (only
    available if the file size is available).

     Speed
    The avarage net number of characters sent or received so far. This should
    be about a tenth of the connect speed (eg. 960 cps at 9600 bps).

     Skip
    This button is available in Zmodem only and skips the current file.

    Note:  The skip option might not work with all Zmodem implementations.

 Disconnect after transfer
    If set, ZOC will disconnect from the remote host after the file transfer

    Note:  Please be careful, ZOC will not properly logoff from your host, but
    it will merely hangup instead. Not all hosts (or sysops) like this.

 Delete file after transfer
    This checkmark makes ZOC delete the file after the transfer. Files are only
    deleted if they were transferred without error and file transfer was not
    aborted by the user.


ΓòÉΓòÉΓòÉ 5. Customizing ZOC ΓòÉΓòÉΓòÉ

 There are basically two sets of options, Global Options and Option Sets.

Global options hardly change once you defined then while it is very likely that
the options from options sets will differ with different hosts you use.
Therefore there is only one set of global options but you can have as many
options sets (containing the other options) as you like.


ΓòÉΓòÉΓòÉ 5.1. Help for Global Options ΓòÉΓòÉΓòÉ

 Global options (as opposed to the options from the Options Sets) are valid for
all connections you make. They contain options that, once they are set, hardly
change at all.

Global options are

o Directory and File Names

o Tool Bar Icons

o Keyboard Redefinition

o Phone Cost Description

o Phone Book/Dialling Options


ΓòÉΓòÉΓòÉ 5.1.1. Defining Directory and File Names ΓòÉΓòÉΓòÉ

 The names defined here are the default directories and file names that are
used in file selection windows or special functions.

Most of them are rather straightforward but some need a few words of
explanation.

 Alt Downl.
    This field defines a directory into which special files are downloaded. The
    file extensions of the files to be put into this directory are defined in
    the transfer section of the options notebook. This directory is mostly used
    to receive mail packets for popular offline mail readers like BlueWave or
    Kurt Westerfeld's KWQ (which is an excellent shareware product, highly
    recommended).

 Editor
    This defines the editor to be used when calling the Cliptext Edit function
    from the Cliptext menu, or when calling the Edit function from the Misc
    menu.

 Shell
    Shell defines a shell to be opened, when calling the OS/2 Shell function in
    the Misc or Transfer menu. This shell is also called with the /C parameter
    if you issue a SHELL command from within a ZOC script.

 Call Log
    This file is a file to which ZOC logs calls to BBSs (C+/C- means
    connect/disconnect) and file transfers (DL means download, UL means
    upload). However, the Call Log is maintained only, if you have 'Valid CD
    signal' enabled (see Serial Options).

 Multimedia Eventfiles
    These are sounds (WAV or MID) or movies (AVI) to be played to indicate
    certain events (of course MMPM/2 has to be installed for this). They should
    be entered with full path.


ΓòÉΓòÉΓòÉ 5.1.2. Setting up the Tool Bar ΓòÉΓòÉΓòÉ

 The toolbar makes functions easily accessible offering icons for them.

To customize the toolbar you can select/deselect icons from a list by clicking
on them with the mouse. Those entries in the list that are drawn with dark
background will be shown in the toolbar (if the window is wide enough).

Additionally (depending on screen resolution and your personal taste) you can
select if you want the icons in the toolbar to be large or small.


ΓòÉΓòÉΓòÉ 5.1.3. Redefining the Keyboard ΓòÉΓòÉΓòÉ

 Generally ZOC produces the correct codes and functions for all keys on the
keyboard. If you need customizable keys, you should use the f-keys (available
in the macros section of the options booklet).

However, in special cases it might be necessary to be able to redefine other
keys.

Warning: It is not recommended to redefine key combinations that are already
covered by ZOC (like the arrow keys). These global keyboard remapping
circumvents ZOC's normal key processing (only menu shortcuts take higher
precedence) and might interfere with normal operation.

To redefine a key, first select the key qualifiers (Shift, Ctrl, Alt, Num Lock,
Scroll Lock), then click on a key to bring up the key redefinition window.


ΓòÉΓòÉΓòÉ 5.1.4. Redefining One Key ΓòÉΓòÉΓòÉ

 After you selected a key to be redefined in the keyboard redefinition window,
a small window appears into which you can type the new value that is sent if
you press that key together with the selected combination of key qualifiers
(e.g. Alt+Ctrl+Z). Additionally you can restrict the redefinition to a special
terminal emulation, that is, if you need a combination for VT102 only, you
would deselect the ANSI checkbox.

Note:  Only simple Control Codes as listed in the appendix can be used.


ΓòÉΓòÉΓòÉ 5.1.5. Setting up the Phone Cost Description ΓòÉΓòÉΓòÉ

 Introduction

To monitor phone charges you need to describe how the cost is calculated based
on the duration, time of day and distance of a call.

First you setup up days and times of day that are of interest for the
calculation. In most countries it is cheaper to make calls in the evening and
on weekends than it is during working hours from Monday to Friday. So, you will
probably end up with three blocks of time like 08:00:00-17:59:59 Mo-Fr,
18:00:00-07:59:59 Mo-Fr and 00:00:00-23:59:59 Sa/Su.

If, like in Germany, some calls don't depend on the time of day, you would need
an additional entry to covers these: 00:00:00-23:59:59 Mo-Fr/Sa/Su.

Next, you would give names like local, near, far, intl. to the distance zones
in the field after the distance zone letters (A-H).

Then you would describe what a call costs at any time of day in the form
<cents>/<seconds>@<time of day> (speak cents per second at time of day) for
each distance zone. For example, if your telephone company charges 6 cents per
minute during working hours and 3 cents per minute during evening hours and
weekends, you would enter 6/60@T1, 3/60@T2 and 3/60@T3 in the fields after the
distance zone description.

Note:  There is an important difference between defining 0.1 cent per one
second and 6 cents per sixty seconds. In the former case you will be billed
exactly 0.1 cent per second, in the latter you will be billed 6 cents at the
beginning of every minute (the minute is called a time-unit). This way you get
18 cents for a 2 minutes 10 seconds call instead of 13 cents (as in the first
case).

If all this is done correctly you can go to the phone book and edit the entries
to assign distance zones to them. After you call such an entry, ZOC will show
you the cost of the call in the Status Line, sum it up in the phone book
entries memo field (see changing phone book entries) and log it to the call log
file (see Directory Options).

 Advanced Cost

In some countries you have to pay some basic fee for the connection to be made
or the first minute is more expensive than later ones.

This can be handled by ZOC's cost management if you define a cost like
<initial-cents>/<initial-seconds>+<cents>/<seconds>@<time of day>. If, for
example, in your country, the first minute of communication costs 15 cents and
every later minute costs 12 cents you would set it up as 15/60+12/60@T1

This feature can also be used, to make the cost management more acurate. ZOC
starts the timer when the remote carrier signal is detected. This might be a
few seconds after the actual connection was made. If you have to pay 12 cents
for a minute of communication and your modem detects the remote carrier about
10 seconds after the remote modem picked up, you could compensate this delay by
defining the cost as 12/50+12/60@T1.


ΓòÉΓòÉΓòÉ 5.1.6. Setting up the Phone Book/Dialling Options ΓòÉΓòÉΓòÉ

 The phone book options control the working of the phone book and of the
AutoDialler.

 AUTODIAL
    The auto dialer is used when you select the dial function from the Phone
    Book or from the Modem Menu It tries to connect you to a given number and
    retries several times if it fails. You can specify the maximum number of
    retries and the time between trials of the same number. If, for example,
    you set the time between attempts to 10 seconds and select three entries
    from the phone book to be called and the call to all of them fails, the
    first one will be called immediately after the third since trying the
    second and the third will very likely need more 10 seconds.

    Some countries require some time to pass before the next number can be
    dialled. So ZOC lets you define the minimum time between tries to call any
    number.

 MISCELLANEOUS

    Load standard options after disconnect
       If this option is enabled (which is recommended) ZOC loads the default
       option set after you disconnect from a host session. This way you will
       have the standard options always active, even after calling a host that
       uses unusual options (e.g. a slow transfer speed).

    Show phone book after program start
       If enabled ZOC will open the phone book directly after being started.

    Multiple selection without Ctrl key
       Normally you have to hold the control key down to select several non
       contiguous entries from the list (which is the way how it is done across
       the entire WPS).

    Large font
       You can choose between a large and a small font to display the list of
       hosts in the phone book.

    Sort order
       Select a sort criteria to control the order in which the hosts are
       presented in the main window of the phone book.

 IEMSI Defaults
    Some BBSs support a method to log in automatically that is called IEMSI
    (you can tell if a BBS supports IEMSI from the **EMSI_IRQ it sends before
    asking for your name (not to be confused with **EMSI_REQ)). The IEMSI
    options are specified for each phone book entry (and are discussed in
    Changing Phone Book Entries), the IEMSI options specified here are the
    defaults that are used if you create a new phone book entry.


ΓòÉΓòÉΓòÉ 5.2. Option Sets ΓòÉΓòÉΓòÉ

This booklet contains all options.  Select a tab with the mouse to open the
according dialog.

Available tabs are: Serial, Terminal, Logging, Modem, Transfer, Emulation,
Macro Keys, AutoMacros, Custom Buttons, AutoReply, Window, Safety, Character
Translation.


ΓòÉΓòÉΓòÉ 5.2.1. Serial Options ΓòÉΓòÉΓòÉ

 This window is used to define serial parameters.  It can be opened via menu or
by clicking on the transfer speed button in the status line.

 Transmission
    In this section you define how data is transferred between your computer
    and the modem (which is not necessarily the same way the modem uses to
    transfer data across the telephone line).  You have to select a speed (bits
    per second), the number of databits, a parity mode (none, even, odd, mark
    or space) and the number of stop bits.

    What you use depends mostly on your host (and, of course, on your modem
    limits).

    These settings are often given (e.g. in instructions of how to call a host)
    in an abbreviated version, like 38400-8N1 (38400 bits per second, 8 data
    bits, no parity, one stop bit).

    Note:  If you have a modem with data compression (MNP5 or V.42) you should
    use a speed that is higher than the actual speed your modem supports.
    Today 14,400 bps modems are very popular.  These use online data
    compression which allows them to transfer actually more than the
    theoretical maximum of 1440 bytes per second.  To take advantage of this,
    you should access these modems with 19,200 or 38,400 bps.

 RTS/CTS handshake
    If enabled, ZOC uses RTS/CTS hardware handshake for communication with your
    modem.

    RTS/CTS is used to control the flow of data between the computer and the
    modem and provides a way for both to prevent the other from sending data.

    This is essential for file transfers when the speed of the modem to modem
    connection is different from the modem to computer connection (which is
    true for MNP5 of V.42 modems).  It is also essential in a multitasking
    environment where the processor might have other things to do when data
    arrives.

    Thus, it is highly recommended to have this option enabled.  However, the
    modem needs to support it as well, so check your modem manual for the
    proper modem command to "enable bi-directional RTS/CTS hardware flow
    control" for use in the modem init string (see Modem Options).

 DSR handshake
    This DSR/DTR handshake is somewhat similar to RTS/CTS as it is a handshake
    method as well.  It does not control the data flow, but the general
    availability of the modem and computer (i.e. if these are turned on).

    If enabled, ZOC monitors the DSR signal for communication with the modem.
    This option should only be enabled if your modem and your cable properly
    provide the DSR signal.  Otherwise ZOC will be blocked.

 XON/XOFF
    If enabled, ZOC uses the Xon/Xoff software handshake for communication
    (which is yet another method to control the data stream).  It uses special
    characters to hold/release the sender.  This method is inferior to RTS/CTS
    handshaking and should only be used if necessary.

 Valid CD signal
    If your modem supports the Carrier Detect (CD) signal (most modems will do
    this if you add AT&C1 to the modem init string in the Modem Options), you
    should enable this option (which is highly recommended).

    ZOC uses the CD signal to control the connection timer and phone cost
    calculation as well as to write a calling log to the file defined in Path
    Options.

 AutoSpeed
    If enabled, ZOC automatically sets the transfer speed to the one received
    when the modem sends a message like 'CONNECT xxxxx'.

    This should not be used if you use a modem that is capable of data
    compression (as MNP5 and V.42 modems are)!

 Device
    You specify the device to which your modem is connected here (probably COM1
    or COM2).  Additionally you can select that ZOC should release the device
    when the window is minimized to let you use a FAX program or another
    communications program (alas!) without having to close ZOC.

 Break signal duration
    The duration that is used for sending a break signal (some hosts use this
    to break an operation) when pressing Ctrl+End.  It is given in milliseconds
    and typically ranges from 250 to 400 ms.

 Timeout Control
    These options control what should happen if no characters have been sent or
    received for some time.

    After a timeout occurred you can have ZOC send something to your host to
    prevent disconnection.  In this case it is a good idea to use a string that
    does not invoke any unwanted action (like paging the sysop for a chat), but
    something neutral like ^M (enter), ^! (break signal) or * (which jumps to
    the main menu on some hosts).

    If you don't like this, you can have ZOC hangup after a timeout.

    If you do not want any timeout control at all, set the time to zero.


ΓòÉΓòÉΓòÉ 5.2.2. Creating a Modem Init String ΓòÉΓòÉΓòÉ

 It sometimes is not easy to find the proper modem init string.  Some comm
programs offer modem databases but with new modems coming to the market almost
every day it is hard to ensure correctness of these.

On the other side, it is not very hard to dig the correct commands from the
modem manual if one knows what to look for.

Modems with data compression have a rather tricky setup, but since modem
manufacturers don't want to spend all their profits on customer support, almost
all of these modems have two factory profiles: Data compression enabled and
disabled.

These profiles can be activated by using rather simple commands (probably
AT&F1), so it is very likely that all you have to do, is to check your modem
manual for factory profile command and use that as the modem init string, e.g.
AT&F1^M (if you use data compression make sure you have RTS/CTS and a
high-speed enabled in the Serial Options).


ΓòÉΓòÉΓòÉ 5.2.3. Terminal Options ΓòÉΓòÉΓòÉ

 This window is used to define general terminal characteristics. It can be
opened from the menu or by double clicking the space between the buttons in the
status line.

 TERMINAL

    Incoming CR -> CR/LF
       This options ensures, that each incoming Carriage Return is followed by
       a Line Feed.  Use this if received text is printed over and over in the
       same line without advancing to the next.

    Strip high bit
       If enabled, all characters in the terminal window are printed with 7
       bits. This can be used if you receive graphical characters where text
       should appear (of course, it does not help if bursts of noise from the
       phone line send garbage to your screen).

    Show ctrl chars
       Show received control-codes as plain text (e.g. ^I for TAB) instead of
       using them.  It is used mostly for problem determination.

    Show hex dump
       This options shows incoming characters as hexadecimal values. It is used
       only for problem determination.

    Destructive backspace
       This options erases characters from the screen if a backspace is
       received (instead of just moving the cursor back one step).

    Local echo
       Print all manually typed characters to the terminal window (normally the
       host sends all typed characters back to display them). This option
       should be used if you use a half duplex connection (which are pretty
       rare these days) or if you type to a host that does not provide an host
       echo (e.g. if you called a friend's computer who uses a terminal program
       as well; however, in this case you are better off with the Split Chat
       from the Misc Menu).

    Send echo
       Loop back all incoming characters to the originator.

       Warning: This may result in an endless loop if the originator also sends
       an  echo (!!!), which is true for most and hosts.

       You can use this, if a friend called you with his modem.

    Translate characters
       If you call a host that uses a different character set than your
       computer, it is possible to have ZOC translate these into your native
       character set (see translation).  The translation can be disabled using
       this option.

    Beep
       This option controls what to do for a beep.  Choices are ignore
       (unchecked), acoustic (checked) or visual (shaded).

 CLIPBOARD SENDING

    Quote always smart
       If selected, the Send-Quoted function from the Cliptext Menu will always
       try to reformat the text before sending it.  When disabled, reformatting
       is still available by holding the shift key pressed.

    Width
       Reformatting for smart quoting will be done in a way that no line is
       longer than the number of characters specified here.

    Always send quick
       Selecting this option will always send marked text at once if only one
       line is marked on the screen.  Otherwise the text will be sent at once,
       if you hold the Shift key pressed while doing a one-line selection.

 SCROLL-LOCK KEY ACTION
    This option lets you map events to the scroll lock key.

    Ignore Scroll Lock
       ZOC ignores the scroll lock state of the keyboard.

    Activate chat field
       Pressing the Scroll Lock key toggles the chat field (see Window Options
       and Screen Elements).

    Toggle doorway mode
       Pressing the Scroll Lock key toggles the keyboard Doorway mode. (Doorway
       mode is a mode in which special key codes are used. It is required by
       software like OS2YOU).


ΓòÉΓòÉΓòÉ 5.2.4. Logging Options ΓòÉΓòÉΓòÉ

 This window is used to define capture parameters.

 Default name
    When you start ZOC, this name will be used as a default name for the
    logfile. You may use special place holders in the name to be substituted by
    ZOC with values like the current month to create dynamic names (see Special
    Codes in the appendix). The file will be placed in the log directory set in
    Path Options unless you supply a path with the name.

 Now active
    Enable saving incoming data in the logfile.  This is the same as the
    checkmark near the log file name in the status line.

 Append
    If logging is activated, data is appended to a existing file rather than
    overwriting it when you start logging.

 Session headers
    Session headers are a few lines of information which are inserted into your
    capture and log file when connecting to a host.  This can only be done if
    you have a valid Carrier Detect signal (see Serial Options).

 DC2/DC4 control
    Some hosts (i.e. CompuServe's mail system) are able to remotely control
    your logging by sending DC2 and DC4 characters (the check mark in the
    status line will turn gray if the hosts suspends logging for you).  This
    can be disabled.

     Size
    Define the size of the memory buffer to hold data for reviewing sessions.


ΓòÉΓòÉΓòÉ 5.2.5. Emulation Options ΓòÉΓòÉΓòÉ

 This window is used to set the emulation.  It can be opened via menu or by
clicking on the emulation button in the status line.

 Swap keys
    If you enable the keys swap option, a Backspace is sent when the DEL key is
    pressed and vice versa, if you are in VT102 mode. This is helpful for many
    VT102 systems.

 Discard codes
    Screen control for ANSI and VT102 is done by sending special control codes.
    Logging of these control codes in the capture/log file should be disabled
    since it makes reading of these rather hard.

    This option is unavailable during TTY emulation.

 Disable VT102 key pad
    In VT102 mode the numeric key pad is used as a replacement for VT102
    auxiliary keypad (see VT102-keyboard).  This can be problematic if you are
    using the cursor keys in the numeric keypad instead of the gray cursor
    keys.  Enable this option, if you are using the numeric cursor keys and if
    you don't need the VT102 keypad in your applications.

    This option is unavailable during ANSI and TTY emulation.


ΓòÉΓòÉΓòÉ 5.2.6. File Transfer Options ΓòÉΓòÉΓòÉ

 These settings define the characteristics of file transfers. They are accessed
via the Options/Settings notebook or by clicking the file transfer protocol
button in the status line.

 PROTOCOL
    Select X- Y- or Zmodem protocol.

    Note:  Some systems falsely offer protocols named Ymodem and Ymodem batch,
    which really are Xmodem with Block-1024 for Ymodem and Ymodem for
    Ymodem-Batch.

    Note:  Other protocols are available as add in modules an can be found in
    the Plugs function (located in the Transfer menu).

 IF FILE EXISTS
    Select what you want to do if you try to download a file that already
    exists on your system.  Additionally specify if you want the old (existing)
    or the new (incoming file) renamed (if rename is chosen).

 Special file extensions
    ZOC lets you list extensions of files that should be downloaded to an
    alternate directory (see Directory Options) and files that should be
    deleted after they are uploaded successfully.

    The extensions may contain the * and ? wildcard characters and need to be
    separated by vertical bars (without space characters) like this:
    GIF|Q*|MO?|TU?

    Note:  Just specify file extensions, no full file names like like
    *.GIF|ABC.DOC

 XMODEM
    These options only apply when the Xmodem protocol is selected.

    CRC on
       CRC is controlled by the receiver of a file.  CRC can be used instead of
       the less reliable Xmodem checksums.

    Blocksize 1024
       With this option Xmodem uses blocks of 1024 instead of 128 bytes.  Some
       systems falsely call this Ymodem.  The block size is controlled by the
       sender.

    Chop pads
       If enabled, ZOC tries to remove padding bytes at the end when receiving
       a file.

 ASCII-UPLOAD
    These options are used for ASCII-Uploads and for sending the clipboard
    contents.

    CR -> CR/LF
       Ensures that each Carriage Return is followed by a Linefeed.

    Char-Delay
       ZOC waits n milliseconds, before sending each character.  Four times
       this time is waited at the end of each line.

 MISCELLANEOUS

    Start picture viewers
       ZOC is able to show pictures while downloading them.  For this purpose
       the files TAP_GIF.EXE and TAP_JPG.EXE are provided in your ZOC
       directory. If you don't like this feature, it can be disabled (you still
       can start a viewer manually from the WPS before downloading a picture).

    Time critical
       Enabling this options boosts ZOC's priority during file transfers, which
       might help to increase transfer throughput and reduce transfer errors in
       some very special cases.

       Warning: This will very likely impair the performance of other tasks.

 ZMODEM

    Auto transfer
       If enabled, ZOC starts Zmodem transfers automatically.

    Ignore time stamp
       Select this option, if you want received files to be marked with the
       date/time of download, instead of being marked with the time stamp the
       file carried on the file system of the sender.

 ZMODEM (UPLOAD ONLY)
    These options apply only to uploads.  They are only effective, if the
    receiver is able and willing to handle them, so they may or may not have an
    effect on an actual file transfer, depeding on the receiver's Zmodem
    implementation (they work best when used to send files to Omen Technology's
    RZ or DSZ, which is available on various platforms including Unix, VMS and
    MS-DOS).

    You can specify that you want the receiver to convert carriage returns and
    line feed according to it's platform and you can suggest what the receiver
    should do if a file aready exists on it's  machine.  Options are to use the
    receiver's default action, to always overwrite files, to overwrite files if
    their file date is older, to resume an aborted file transfer or append the
    data to the existing files (the corresponding Unix SZ options are -p, -y,
    -n, -r, -+).


ΓòÉΓòÉΓòÉ 5.2.7. Modem Options ΓòÉΓòÉΓòÉ

 This window is used to define the strings ZOC uses to communicate with your
modem.  These strings may contain control characters (e.g. ^M, see Special
Codes), the tilde (~, which is a delay of 1/3 sec) and ^# to be substituted
with a phone number.

 Initialization
    This is a list of modem commands to set the modem to a given state before
    using it.  You should be aware that ZOC (unlike some other programs)
    requires a ^M at the end of the initialization string.

    If you don't know what to use for the initialization string, please check
    the Modem Init section of this help file for advice.

    Depending on your setup, you might want to send the initialization string
    every time you load an options file (thus having different options files
    for different modem configurations).

    Normally ZOC does not send an init sequence if it finds a carrier detect
    signal from the modem (thus preventing a modem reset while you are online).
    However, some modems provide a CD signal after power on.  In this case you
    should enable this option (and add AT&C1 to the modem init string to tell
    the modem to provide a real carrier detect signal).

 Dialling
    ZOC lets you set up four dial commands for calling different types of
    numbers (i.e. using a credit card number to make long distance calls).  You
    can select the dial command to be used from the Phone Book and when dialing
    manually (from the Modem Menu).

    The dial commands need to consist a ^# sequence to be substituted with the
    phone number you want to call, thus a standard dial command would look like
    ATDT ^#^M (meaning send ATDT, then the phone number and then enter).

    If you want to issue a modem command before dialing you should add some
    tilde characters between the modem and the dial command (like in
    ATZ^M~~~ATDT ^#^M) to give the modem time to process the former.

 Hangup
    ZOC supports two methods of telling a modem to hang up.  Using the DTR
    signal of the com port is the superior of the two.  If you disable it, ZOC
    will use the ATH command.

 Auto answer
    Here you supply two modem commands to enable and disable the modem's auto
    answer mode.  These are ATS0=1^M and ATS0=0^M for basically all modems.

 Modem Response Strings
    Here you provide ZOC with the responses the modem sends when making or
    failing to make a connection.  These are used by ZOC to determine if a
    connection was made, if ZOC has to redial or if ZOC should abort the
    dialling process (e.g. because of an incoming call).

    The modem responses have to be separated by a vertical bar (|) without
    spaces like CARRIER|CONNECT.

 DTR Control for DOS-Transfer
    These are two special modem control commands which are needed to give DOS
    programs access to a ZOC session (see Transfer DOS-Shell). These commands
    need to switch the modem's DTR action from hangup to ingore and vice versa
    while being online.  By default this is achived, by sending the modem's
    escape string with a pause of 1.3 seconds (+++~~~~), then sending the modem
    command to set DTR action and giving the modem time to OK (ATDx^M~~). After
    that the modem is switched back to online operation (ATO^M). These commands
    may vary with some modems brands; if they don't work with your's, please
    check your modem manual for equivalent commands.

Note:  This page of the options booklet may be protected by a password (see
Safety Options) since some people store card call numbers in the dial prefixes.


ΓòÉΓòÉΓòÉ 5.2.8. F-Key Macro Definition ΓòÉΓòÉΓòÉ

 It is possible to map text or REXX file execution onto the F4-F12 or
Shift+F1-F12 keys (F1-F4 are not available, since they are used in VT102 and to
provide help; if you need to define F1-F4 anyway, it is possible to redefine
them using Global Keyboard Remapping which always takes precedence over this
function).

The execution of a script file can be mapped onto a function key by defining
the key as ^RUN=<scriptname> (e.g. ^RUN=MY_SCRIPT).

If you use the special code of ^& in a macro key, ^& will be substituted with
the value of the password field of a phone book entry after you successfully
connected to that host via the phone book (see phone book entries).
Additionally there are special codes for date and time of day.  Check Special
Codes in the appendix for a complete list.

Note:  This page of the options booklet may be protected by a password (see
Safety Options).


ΓòÉΓòÉΓòÉ 5.2.9. Definition of the AutoMacros ΓòÉΓòÉΓòÉ

 Besides the function key macros ZOC provides so called Auto-Macros.  The idea
of AutoMacros is borrowed from text processing where (at least in good
programs) the feature is called Auto-Correct or Auto-Text.

You can think of AutoMacros as abbreviations.  Whenever ZOC finds that you
typed some text that is found in the abbreviations, ZOC will replace it with
the full text you provide here.  This is done by sending backspace characters
to delete the abbreviation (if necessary) and then sending the full text (if
the abbreviation and the full text begin with the same characters  ZOC will
only backspace the part at the end that differs, like Datcom and
Datacommunication).

To avoid erroneous replacement of characters that belong to a word,
abbreviations are matched case sensitive and replaced only if there is a non
alphanumeric character typed before and after the text.  So, if you defined Com
as an abbreviation it will be replaced if you type Data-Com_ or Com-Port, but
not if you type The Com1-Port or DataCom_.

Besides correction of typing errors there are many other uses for this feature
in a terminal application.

o Abbreviations for commonly used phrases like Ttyl being replaced with Talk to
  you later

o Abbreviations for logins like replacing MS with Markus Schmidt^Msecret (to
  send user name and password at login prompts).

o Abbreviations for commands when using a shell on a UNIX or VAX host. (e.g.
  using lo instead of logout).

o Nicknames for e-mail addresses (like replacing ms@ with
  [e-mail]).

Note:  This feature is disabled during REXX and script execution and during
AutoLogin and Learn mode.

Note:  You can enter text into a Full Text field only if the corresponding
Abbreviation field is non empty.

Note:  This feature is similar to the AutoReplies and some results can be
achieved by using both methods.  However there are some important differences:
1) AutoReplies monitor the incoming data stream (sent by the host), AutoMacros
watch the keystrokes from the keyboard. 2) AutoReplies can invoke REXX
programs, AutoMacros can't.

Note:  It is a good idea to append a period or an exclamation mark to the
abbreviation text (like MS. or lo!) to make it really unique.  This way
inadvertent invocation of the full text will be highly unlikely.


ΓòÉΓòÉΓòÉ 5.2.10. Definition of the Custom Button Bar ΓòÉΓòÉΓòÉ

 Below the tool bar reside a group of user defined buttons that can be
specified here.  You can set the value to be sent when the button is clicked
with the mouse as well as a short text to describe the button (which is shown
inside the button in the custom button bar).

It is possible to use the button for script execution, as well as for sending
text (that may contain control codes), a password or the value of a function
key.

Please check Special Codes in the appendix for a complete list.

Note:  This page may be protected by a password (see Safety Options).


ΓòÉΓòÉΓòÉ 5.2.11. Definition of the AutoReplies ΓòÉΓòÉΓòÉ

 Auto replies provide a way to automatically send text or invoke REXX programs
(or other magic) whenever a group of specific characters is received.

To do this, you just enter the text that invokes the action in the
Incoming-Text field and provide some text or a REXX name (preceded by ^RUN=,
see Special Codes) in the Action field.

This feature can be used to

o Automate logins: You could automatically send your username and password (or
  ^&, see Special Codes) when receiving the text User name?

o Skip birthday checks: Some hosts ask for your date of birth now and then to
  make sure no one else uses your account.  Using AutoReplies you can provide
  the date automatically when receiving the prompt.

o Reading mail: When you receive the You have mail notification from your unix
  host, you could start your mail reader by replying ELM^M.

Warning: You should make sure that the text you are looking for really is
unique.  It is better to wait for the text --More-- than it is to wait for More
to automatically answer such prompts.

Note:  This feature is disabled during REXX and script execution and during
AutoLogin and Learn mode.

Note:  You can enter text into an Action field only if the corresponding
Incoming Text field is non empty.

Note:  This feature is a bit similar to the AutoMacros, please check the note
about the differences provided there.


ΓòÉΓòÉΓòÉ 5.2.12. Window Definition ΓòÉΓòÉΓòÉ

 SCREEN ELEMENTS

    Initial Help
       Here you can turn off the help window that appears when you start ZOC.

    Menu
       Since ZOC shows a popup-menu when you click the right mouse button in
       the main window, you can disable the permanent menu below the title bar.

    Tool bar
       Here you can turn the toolbar on or off.

    Custom button bar
       Here you can turn the strip with custom buttons that appears below the
       toolbar on or off.

    Chat field
       Here you can turn off the chat field (see screen elements). The chat
       field is an input field above the status line that lets you type, edit
       and retrieve earlier typed text.  The text is sent to the host when you
       press enter.  This is useful if you join an online conference with many
       people or if you work with a shell on the remote host that does not
       provide command editing or a command history.

       The chat field can be turned on and off with the Scroll-Lock key as well
       if you defined this in terminal options, or by pressing Alt+C.

       Note:  To chat with a friend who called you, you better use the Split
       Chat feature from the Misc Menu.

    Status line
       Here you can select, if you want to see the status line.

    Snippets
       ZOC monitors your input data stream for filenames, fido node numbers,
       CompuServe user IDs and Internet user IDs and collects them in a little
       window that floats aside the ZOC window (see Misc Menu).  With this
       option you can hide (grayed) or show (checked) the window or turn this
       feature off (unchecked) to save CPU load.

       Note:  You can change the font of the Snippets window by dragging a font
       from the System->Setup->Fonts folder of OS/2 and dropping it above the
       Snippets window.

 WINDOW SIZE
    You can select the window size here (columns by rows).  Additionally you
    can specify if you want ZOC to change the number of rows and columns after
    the window was sized with the mouse, or if ZOC should keep the size and add
    scroll bars instead.

 WINDOW (FONT/COLOR/HANDLING)

    Font size
       Select a font size for the terminal window from the list (the selection
       of other fonts than System VIO is not possible).  Additionally you can
       select that ZOC should try to find a fitting font (while retaining the
       same number of rows and columns) after the window was sized with the
       mouse.

    Hide while dialing
       If you don't want the large ZOC window around while dialing you can
       select this option.  In this case ZOC will hide while dialing, just
       leaving the small dial progress window on the screen, and come back
       after it made a connection (or failed to do so).

    To front when carrier detect
       If set, the main window of ZOC will come to the top of all windows if
       the modem carrier detect signal is switched on (as it is when connecting
       to your host).  This way you can have ZOC dial in the background and
       jump in if a connection was made.

    Minimize during file transfer
       If you don't want the large ZOC window around during a file transfer is
       going on, this options minimizes the ZOC's main window after starting
       the transfer.

    To front after file transfer
       If set, the main window of ZOC will come to the top of the desktop after
       a file transfer has been completed.  This way you can put ZOC aside to
       do other work during a file transfer without missing the transfer's end.

 BROWSE WINDOW FONT
    Select a font size for the browse window (that shows the capture buffer).
    The selection fonts other than System VIO is not possible.

 NATIONAL SUPPORT
    If your host sends a character set that is supported by an IBM code page
    you can specify it here.

 SCROLL JUMPS
    While offering superior ease of use, graphical user interfaces like the
    OS/2 WPS have to handle far greater amounts of memory to maintain their
    displays than text based user interfaces have (e.g. a character in a text
    mode application is stored in two bytes while a 8 by 14 character on a 256
    color screen uses 104 bytes).

    This results in rather high CPU load, especially when scrolling.  Because
    of this, ZOC is only able to write text to the screen with about 4800 bps
    if the text appears at the bottom of the window and it's necessary to
    scroll up.  However, you can allow ZOC to delays scrolling until a few
    lines (e.g. five) of text have arrived.  This way ZOC saves CPU cycles
    (since it needs to move the image only one instead of five times and since
    it does not make a difference how far it is moved). Obviously output speed
    benefits from this (while the scrolling appears rather "jumpy" instead of
    smooth).  The farther the jumps you select (normally flea jumps should be
    enough) the more lines ZOC will collect before actually scrolling and the
    faster output will be.

 SHOW TIMER AS
    This option controls the display of the phone cost in the status line.

    Money
       Show the time elapsed since connecting to a host (or resetting the
       timer) as a money value (according to the Cost Setup).

    Fraction
       Show how many cost units are used so far.

    Online time
       Show the time elapsed since connecting to a host.

 MISCELLANEOUS

    Disable RD/SD LEDs
       Here you can turn off the (maybe annoying and, more important, processor
       time consuming) flashing of the third and fourth LED in the Status Line
       that emulate the modem receive-data and send-data LEDs.  If the
       checkmark is in indefinite state (shaded) the LEDs will be enabled
       during text output but disabled during file transfer (which is highly
       recommended unless your computer is a real killer machine).

    Big cursor
       Enabling this option makes the cursor in the main window a bit bigger.


ΓòÉΓòÉΓòÉ 5.2.13. Safety Options ΓòÉΓòÉΓòÉ

 Define if you want to be warned before performing "dangerous" operations or if
you want to protect the setting of the macro keys and custom buttons.

 Confirm ...
    This should be self explanatory.

 Warning if high-speed ...
    The RTS/CTS handshaking method provides reliable control of the data flow
    between the PC and the modem.  If you use high transfer speeds without
    RTS/CTS handshake you will very likely encounter transmission errors.
    Enabling this option gives you a warning if you select more than 4800 baud
    without selecting RTS/CTS as well.

 Save options ...
    Here you can select if you want to save options automatically when you
    leave the program.

 Lock Macro Keys
    If you leave your computer unattended for a while, you can lock the macro
    keys to prevent unauthorized use.  To unlock them, input of the password
    you define below is required. Locking can also be initiated from the Misc
    Menu.

 Password
    If a password is specified, the dialogs for Macro Key Definition, User Bar,
    Modem, Keymacro Unlocking (in the Misc Menu) and Phone Book Definition (if
    it contains a password) will ask for it, because often passwords to access
    online services are stored in these places.

        CAUTION:
    The password is case sensitive. However, all this is far from industrial
    strength protection. It just gives you protection against casual attempts
    to gain access to your data


ΓòÉΓòÉΓòÉ 5.2.14. Translation of Inbound/Outbound Characters ΓòÉΓòÉΓòÉ

 Users in countries that do not use the US-Ascii character set often end up
with the problem that the codes of characters that are sent by the host do not
match the codes used by the terminal program/operating system.

This dialog lets you define the translation of the codes of received and sent
characters or reset these tables to their default (non translating state).

Note:  The translations are only active if the Translate Character option is
enabled in the Terminal Options.

Assumed your host sends (and needs to receive) the character  { instead of the
German letter  О (as some hosts in Germany do) and you have the letter  О on
your keyboard.  In this case you would change the code 123 of the receive table
into 142 ('123 { -> 142 О' would appear in the window) to translate the
incoming character correctly to your screen and you would convert code 142 of
the send table into 123 to send the code the host expects if the you press the
О-key.


ΓòÉΓòÉΓòÉ 6. ZOC Automation ΓòÉΓòÉΓòÉ

 There are two methods available to automate your work using ZOC:
REXX-Programming and Script-Programming.

The REXX interface was introduced in V2.0 and should be used instead of the
scripts since it has superior execution control (loops, decisions) and variable
management.

Scripts are (and will be) maintained for downward compatibility (they were the
sole method of automation in the 1.x versions of ZOC) but will not be improved
in future.


ΓòÉΓòÉΓòÉ 6.1. REXX Programming ΓòÉΓòÉΓòÉ

 If you are not yet familiar with the REXX programming language you should
check the REXX-Information in your WPS System folder, an OS/2 book (like OS/2
Unleashed) or the printed ZOC documentation. A look at the examples in the
ZOC\SCRIPT\RXSAMPLE directory will teach you the basics as well.

Why REXX?

 Ease of use
    The REXX language offers a large set of structured execution control
    statements like IFs and DOs where ZOC Scripts just offer GOTOs.

 Speed
    ZOC runs REXX programs (unlike scripts) in an own thread (task) parallel to
    ZOC's main thread which gives REXX superior execution speed (compared to
    scripts).

 Standards
    REXX is a standard, scripts are YALTL (yet another language to learn). So
    if you learn how to REXX you will be able to use that knowledge in OS/2
    command files and other applications.

How to REXX

ZOC determines that a file is a REXX program by looking at the first line which
should contain a comment like /* REXX */

When running REXX programs ZOC adds a few commands to the REXX language (see
REXX Command List in the appendix) to give REXX access to ZOCs communication
features. The particular commands are discussed in the command list and basics
are shown in the printed manual - this section will cover a few very special
topics about the ZOC <--> REXX interface.

 Tracing
    To find how REXX works, insert a TRACE A command into your REXX programs.
    After that the REXX interpreter will show you each step as it executes it.

 Screen Input/Output
    ZOC supports the REXX PULL and SAY commands which are redirected to the ZOC
    window. However, texts printed using SAY are not scanned for control
    characters (like ^M) while texts printed with the ZOC commands
    WRITE/WRITELN are.

 Issuing OS/2 commands
    Normally OS/2 commands like REN or DEL can be issued directly from a REXX
    program since CMD is the default addressee. In ZOC however, ZOC is the
    default receiver of commands, so you need to address OS/2 commands to the
    command interpreter explicitely, like ADDRESS CMD DEL FOO.TMP.

 Command Arguments
    Some ZOC commands use more than one argument (e.g. the ASK command). If
    arguments contain space characters, you need quotes to make clear what
    belongs to which argument. For example, in ASK Enter Name the word Name
    could be interpreted as part of the first argument (i.e. being part of the
    title) or a second argument (the value to preset the input field with). The
    ZOC interpreter would chose the latter.

    To make the command clear it comes to mind to use quote characters.
    Unfortunately REXX parses away quotes, so, given you would write ASK "Enter
    Name" you would still end up with a window containing the text Enter in the
    title bar and the input field preset with the text Name.

    To work around this problem, you have to use single quote (я) to enclose
    the command or argument like ASK я"Enter Name"я or, which is more common,
    яASK "Enter Name"я.

    It gets real tricky if you have an argument that is stored in a REXX
    variable. If you use the method described above would get the name of the
    variable instead of its value, if you don't, you would have the problem
    already described. Of course there is a solution and it looks like this:
    ASK я"я || titlevar || я"я.

A Small Example Most of the time you will use REXX to log into a host and do
things automatically for you. Simple logins can be stored directly in the phone
book (see Changing Phone Book Entries) and can be recorded automatically.

The example below calls a host and shows how to use REXX with ZOC (as well as
the REXXHOST sample in the SCRIPT directory does).

/* REXX script to dial (and retry) a phone number */

/* Ask user what number should be dialled */
'ASK "What number shall I dial?"'

/* dial the number if it was non empty and if user
   did not press the ESC key */

IF ZOCRESULT()\="" & ZOCRESULT()\="##CANCEL##" THEN
DO
   /* redial 5 times max. */
   DO TRY=1 to 5

      SAY "Try #" TRY

      'DIAL "' || ZOCRESULT() || '"'

      /* wait for a reply within 60 seconds */
      'TIMEOUT 60'

      /* scan the next 6 lines for something interesting */
      DO LINE=1 TO 6
         /* receive next line of text */
         'GETLINE'

         /* if timed out, end script with error */
         IF RC=640 THEN SIGNAL ERROR

         /* if BUSY was received, try again (leave inner loop) */
         IF ZOCLASTLINE()="BUSY" THEN LEAVE LINE

         /* if NO CARRIER was received, end with error */
         IF ZOCLASTLINE()="NO CARRIER" THEN
         DO
            SAY "Error!"
            LEAVE TRY    /* leave outer loop */
         END


         /* if CARRIER or CONNECT was received, everything's fine */
         IF LEFT(ZOCLASTLINE(),7)="CONNECT" | ,
             LEFT(ZOCLASTLINE(),7)="CARRIER" THEN
         DO
            'BEEP 3'  /* page user */
            LEAVE TRY    /* leave outer loop */
         END

      END LINE

      'DELAY 30' /* wait 30 seconds to dial next */

   END TRY
END /* IF */


ΓòÉΓòÉΓòÉ 6.2. Script Programming ΓòÉΓòÉΓòÉ

 The script language is inferior to REXX programming and hence will not be
improved beyond its current state. It is (and will be) mainly available to
maintain compatibility with earlier versions of ZOC.

This section is addressed to those who are already familiar with ZOC scripts
and who don't want to move over to REXX.

The appendix contains a list of all the available script commands.

About the Script Parser

 Note 1: Recognition of commands and system variables is case insensitive, but
     user defined variables are case sensitive.

 Note 2: Metas (=variables) are written between percent signs (like in DOS
     batch files). If a name of a meta is not recognized, the expression
     represents itself, that is, if you write WRITE "%ABC%" and ABC does not
     exist, ZOC prints '%ABC%'.

 Note 3: Each line of code is processed in two steps. First all variables are
     replaced with their value. Second, the parser collects arguments and
     passes them to the commands. Arguments are delimited by TAB or Space,
     arguments containing TAB or Space must be enclosed by single or double
     quotes.

     The following commands are legal:

      SETA "string1" "Hello World"

      SETA string1 "Hello World"

      SETA string2 Hello

      WRITE "%string2%"

      WRITE %string2%

     The following commands are not legal:

      WRITE %string1%

      SETA string1 Hello World

     As a rule of thumb it is a good idea to include all <text> arguments in
     quotes, while it is generally safe and easier to read to leave arguments


ΓòÉΓòÉΓòÉ 7. About ZOC (Versions, Author, Orders, ...) ΓòÉΓòÉΓòÉ

The Order Form from the help menu provides most of the information necessary to
order ZOC (like a list of distributors/registration sites and automatic pricing
calculator).

Click here for details about ordering and payment

Other related topics are How to Contact the Author, Versions of ZOC and A Word
about Shareware.


ΓòÉΓòÉΓòÉ 7.1. Where/How to Order ΓòÉΓòÉΓòÉ

 Select Order Form from the help menu to get an order form, distributor list
and automatic pricing calculator.

 Orders
     The most convenient way to order ZOC is to logon to CompuServe, type go
    swreg at the forum! prompt, search for ZOC and register online. I will be
    notified that you registered and a few days later (currently I process
    orders twice a week) you will receive e-mail on CompuServe which contains
    your software license code and instructions how to use it. The price will
    be charged with your next CompuServe bill.

    If you don't want to order via CompuServe (or if you don't have an account
    there), select 'Order Form' from the help menu and enter your personal
    data, method of payment (see below) and options. Then print or file the
    order form. ZOC will compute the price automatically and print (or file) it
    with the order form.

    In return to your order you will receive a letter (and probably email/fax)
    that contains a license, information on how to remove the display of the
    order form after each download and - if you ordered one - a printed manual
    and a disk.

 Distributors
    You find the complete list of distributors/registration sites  (address and
    phone/fax/bbs numbers) in the order form.

 Options
    There are a few options to chose from.

    License until 2.99
       The basic license is a code that is entered into ZOC (and stored into
       your OS2.INI) to remove the registration remainder screens and messages
       from all versions with the same major version number (currently all 2.xx
       versions).

    Future license
       While the basic license entitles you only to use all versions with the
       same major registration number (e.g. all 2.x versions), you can register
       all future versions in advance (for the price of one upgrade). This way
       you have free access to all future versions of ZOC.

           Disk+Manual
       If you want, you can order a printed manual and a disk containing the
       current version of ZOC and ZOC related files. The commercial style
       printed manual provides basically the same information as the help file
       but adds introductory guidance to datacommunication and REXX
       programming.

 Pricing
    Automatic pricing table is available from the Order Form (to be found in
    the help menu).

    When considering whether to buy ZOC, you should be aware that most
    commercial packages (either for OS/2 or Windows(TM)) without future
    upgrades cost more than the V9.99 license of ZOC.

 Payment
     The notes below apply only if you register from the author! If you plan to
    register from a registration site, please contact them for payment details.

    Credit Cards
       I accept VISA, MasterCard and Eurocard.

       Credit cards are always charged in DM.

       To prevent credit card fraud I need an order form with your written
       signature (i.e. a FAX or a letter) and with your credit card number and
       expiration date.

           CompuServe
       CompuServe offers a convenient shareware registration feature. To use it
       you need a CompuServe account. CompuServe registration is only available
       for the future license without manual and costs additional $5 since
       CompuServe charges 15% for the SWREG feature.

           Check
       Checks are fine with me. Just send a personal check in the currency you
       like (covering the amount to be charged by the registration site in your
       country).

       If you order from Germany, send me an Euro- or Verrechnungsscheck
       (please don't send Verrechnungsschecks by registered mail).

           Cash
       If you send cash, please use registered mail. I will come up for the
       additional postage (that is, you pay $5 less for ZOC).

    Bank Transfer
       I guess this is convenient only if used from inside Germany. If you send
       money via Bank Transfer please send an order form (via mail) as well. My
       bank is POSTGIROAMT NЪRNBERG (BLZ 760 100 85), account is 0314153856.

       Note:  If possible, please don't use bank transfers from other
       countries, since I am charged a transfer fee that is rather prohibitive!


ΓòÉΓòÉΓòÉ 7.2. A Word (or two) about Shareware ΓòÉΓòÉΓòÉ

 Shareware restriction and nagging

    I believe in uncrippled shareware, but I believe as well that moderate
    reminders (widely known as nagging) are an acceptable method to make sure
    that shareware will be registered.  The shareware version of ZOC is fully
    functional. If you feel that something important is not working, you are
    probably doing something wrong.

    In ZOC, the order form and this help topic are shown after every successful
    Zmodem download as a reminder that you should register after the trial
    period.

    Personally I would have preferred to use a method that begins to show the
    window AFTER the trial period, but this is technically not possible without
    risking that someone will fiddle with the method of time measuring to gain
    free access to ZOC. However, you can fully explore the program and won't
    see the reminder too often anyway. If you find this unacceptable, you might
    consider if you already are using ZOC enough that you should register.

    Note:  Btw, I have already seen more than enough discussions about ZOC's
    way of nagging, so I won't contribute to any such discussion going on on
    the networks, even if I monitor it.

 Fairness
    Please be aware that shareware is Fair-Ware and that the shareware concept
    requires fairness from the user. It is possible to use shareware programs
    eternally without paying for it, but, in the long run, this will hurt the
    users as bad as the authors.

    If the shareware concept does not work, more and more programmers will
    market their work commercially without giving the user the opportunity to
    legally test the program for some time (the list of programs that were
    changed from shareware into commercial packages already is quite long).


ΓòÉΓòÉΓòÉ 7.3. ZOC Versions ΓòÉΓòÉΓòÉ

 ZOC light
    ZOC light is currently available in Germany only and is bundled with modems
    from several manufacturers. ZOC light is free and you may use it as long as
    you want but a few features are disabled. To get a full version you should
    contact the distributor listed in the startup panel.

 ZOC unregistered
    This is the shareware version of ZOC which you may evaluate for 30 days. No
    features are missing or disabled, but the order form is shown after each
    download to remind you that you should buy/register it after 30 days.

 ZOC registered
    This is the ZOC version you should go for. When you buy/register ZOC you
    get a software license code that is entered into ZOC to remove the 30 days
    reminder and the order form from the unregistered version.


ΓòÉΓòÉΓòÉ 8. APPENDIX ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 8.1. Function Shortcuts ΓòÉΓòÉΓòÉ

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéKey         ΓöéFunction            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPgUp        ΓöéUpload              Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéCtrl+PgUp   ΓöéASCII Upload        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéPgDn        ΓöéDownload            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéShift+InsertΓöéCliptext, Send      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+Insert  ΓöéCliptext, Send      Γöé
Γöé            ΓöéSpaced              Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéCtrl+End    ΓöéModem, Send Break   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+B       ΓöéCapture, Browse     Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+C       ΓöéShow/Hide Chat      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+D       ΓöéModem, Phone Book   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+E       ΓöéMisc, Editor        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+H       ΓöéModem, Hangup       Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+J       ΓöéTransfer,           Γöé
Γöé            ΓöéTransfer-Shell      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+L       ΓöéCapture, Open/Close Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+N       ΓöéModem, Call Next    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+P       ΓöéLogfile, Log To     Γöé
Γöé            ΓöéPrinter             Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+Q       ΓöéCliptext, Send      Γöé
Γöé            ΓöéQuoted              Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+S       ΓöéOptions, Settings   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+U       ΓöéTransfer, Plugs     Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+X       ΓöéEnd Program         Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+Y       ΓöéEnable/Disable SplitΓöé
Γöé            ΓöéChat                Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt+Z       ΓöéMisc, Clear Screen  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt +       ΓöéStart REXX          Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt -       ΓöéStop REXX           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt ,       ΓöéShow/Hide Snippets  Γöé
Γöé            Γöéwindow              Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt /       ΓöéMisc, OS/2 Shell    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéAlt *       ΓöéCliptext Print      Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 8.2. VT102 Auxiliary Keypad ΓòÉΓòÉΓòÉ

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéVT102 KeypadΓöéPC MF-Keypad   Γöé
Γöé            Γöé(Num Lock Off) Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[PF1]       Γöé[F1]           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[PF2]       Γöé[F2]           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[PF3]       Γöé[F3]           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[PF4]       Γöé[F4]           Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[0] ... [9] Γöé[0] ... [9]    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[Enter]     Γöé[Enter]        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[.]         Γöé[./Del]        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[-]         Γöé[-]            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé[,]         Γöé[+]            Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 8.3. Special Codes ΓòÉΓòÉΓòÉ

 Sometimes it is necessary to send characters that are not available from the
keyboard or that cannot be entered into a field because WPS uses it to move the
cursor (like the ESC or Enter key).

ZOC offers Control Sequences that are replaced with keys that would not be
available otherwise, and special ZOC Codes that give you access to values like
current time or date or let you map action (like running a REXX program or
calling a host) to function keys instead of texts.

The following table shows control sequences that can be used to simulate
special keys when building macro keys, REXX scripts.

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéKey            ΓöéControl   Γöé
Γöé               ΓöéCode      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^ char         Γöé^^        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéBeep           Γöé^G        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéBackspace      Γöé^H        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéTab            Γöé^I        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéEsc            Γöé^[        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéEnter          Γöé^M        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéLine Feed      Γöé^J        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
ΓöéCtrl+^ (dec 30)Γöé^~        Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ

The table below lists place holders that can be used in some ZOC functions to
send special values or achieve other magic like starting REXXs from macro keys.

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéCode    ΓöéExplanation                   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^1      ΓöéReplaced with current day of  Γöé
Γöé        Γöémonth                         Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^2      ΓöéReplaced with current month   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^3      ΓöéReplaced with current year    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^4      ΓöéReplaced with current hour    Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^5      ΓöéReplaced with current minute  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^6      ΓöéReplaced with current second  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^&      ΓöéReplaced with the password    Γöé
Γöé        Γöéfrom the phone book entry thatΓöé
Γöé        Γöéis currently online (for      Γöé
Γöé        Γöésafety reasons this works onlyΓöé
Γöé        Γöéonce per session).            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé~       ΓöéDelay of 1/3 second (only     Γöé
Γöé        Γöéavailable in modem strings)   Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^#      ΓöéReplaced with the phone numberΓöé
Γöé        Γöé(only available in modem dial Γöé
Γöé        Γöéstrings)                      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^!      ΓöéSend a break                  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^RUN=   ΓöéRun the REXX/script file that Γöé
Γöé        Γöéis given after the equal sign Γöé
Γöé        Γöé(available in F-Macros, CustomΓöé
Γöé        ΓöéButtons and AutoReplies).     Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^CALL=  ΓöéCall one or more hosts        Γöé
Γöé        Γöé(separated by vertical bars)  Γöé
Γöé        Γöéfrom the phone book which are Γöé
Γöé        Γöélisted after the equal sign   Γöé
Γöé        Γöé(eg. ^CALL=ZOC InfoBBS|Big    Γöé
Γöé        ΓöéBlue/2|CompuServe)            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^FKEY=n ΓöéMaps the text of a function   Γöé
Γöé        Γöékey to a Custom Button or     Γöé
Γöé        ΓöéAutoReply (e.g. ^FKEY=12, onlyΓöé
Γöé        Γöéavailable in Custom Buttons   Γöé
Γöé        Γöéand AutoReplies).             Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^SHELL= ΓöéStarts an OS/2 command (eg.   Γöé
Γöé        Γöé^SHELL=KQW.EXE) from a F-Key, Γöé
Γöé        ΓöéCustom Button or AutoReply. ToΓöé
Γöé        Γöéstart more than one command,  Γöé
Γöé        Γöéseparate them by an & (eg.    Γöé
Γöé        Γöé^SHELL=cd \tmp & del *.tmp).  Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^XFER=  ΓöéStarts an OS/2 command in a   Γöé
Γöé        Γöétransfer shell (eg.           Γöé
Γöé        Γöé^XFERSHELL=CKERMIT -l %ZOCHFC%Γöé
Γöé        Γöé-r, see Transfer Shell) from aΓöé
Γöé        ΓöéF-Key, Custom Button or       Γöé
Γöé        ΓöéAutoReply. To start more than Γöé
Γöé        Γöéone command, separate them by Γöé
Γöé        Γöéan & (eg. ^XFERSHELL=CD       Γöé
Γöé        Γöé\M2ZMODEM & M2ZMODEM -u       Γöé
Γöé        Γöé%ZOCHFC% -r DOWNLOAD).        Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöé^DOSXFERΓöéStarts a DOS command in a     Γöé
Γöé        Γöétransfer shell (eg.           Γöé
Γöé        Γöé^DOSXFER=DSZ port 2 rz) from aΓöé
Γöé        ΓöéF-Key, Custom Button or       Γöé
Γöé        ΓöéAutoReply.  See Transfer      Γöé
Γöé        ΓöéDOS-Shell for more details.   Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 8.4. REXX Commands/Functions ΓòÉΓòÉΓòÉ

 ASK [<title> [<default>]] Show a text input window and read text from user. If
     the second argument (<default>) it is provided, the entry field will be
     preset with this value. The result of the command can be obtained using
     the ZOCRESULT() function.

     Example:

          ASK я"Are You sure?"я No

          IF ZOCRESULT()==No THEN ...

 BAUD <baud>[-{7|8}{N|O|E}{1|2}] Set serial parameters.

     Example:

          BAUD 38400-8N1

 BEEP [<n>] Beep n times.

 CAPTCLR Clear the capture buffer.

 CLS Clear the screen.

 DELAY [<sec>] Wait a given time or delay 1/5 second if the parameter is
     omitted.

 DIAL [<number>] Dial a number or read the number to dial from the user if the
     parameter is omitted.

 DOWNLOAD {X[C]|Y|Z} <file/dir> Download file(s) using the X/Y/Zmodem file
     transfer protocol. The second parameter is a filename for Xmodem and a
     directory to store the received file(s) for Ymodem and Zmodem

     Example:

          DOWNLOAD Z C:\ZOC\INFILES

 ENDZOC Terminate ZOC and return to shell or WPS

 GETFILENAME <title> Display a file selection window and return the filename in
     ZOCRESULT().

     Example:

          GETFILENAME Enter file to upload

          UPLOAD Z ZOCRESULT()

 GETLINE Wait for the next non empty line of text from the modem (if you want
     to wait for the next line, no matter if empty or not, use WAIT ^M). The
     received text is available using the ZOCLASTLINE() function. If GETLINE
     times out it returns a value of 640 in RC.

     Note:  Since REXX is running in an extra thread, it is possible that
     (especially in loops) GETLINE will miss lines if the text is coming in
     very fast.

     Example:

          GETLINE

          IF RC\=640 & ZOCLASTLINE()==CONNECT THEN ...

 HANGUP Disconnect line.

 LOADOPTS <optsfile> Load options file.

     Example:

          LOADOPTS OPTIONS\VT102OPT

 LOGNAME <filename> Set new name for logging.

     Example:

          LOGNAME TODAY.LOG

 LOGGING [0|1] Suspend/resume logging.

 NOTIFY <text> Display message window.

     Example:

          NOTIFY Hello World!

 PRINT <text> Same as WRITELN

 REQUEST <title> <opt1> [<opt2> [<opt3>]] Display a requester window with
     options (result in ZOCRESULT()).

     Example:

          REQUEST я"Are you sure?"я Yes No я"who cares"я

 REPLY <text1> [<text2>] Send <text2> whenever <text1> is received during (and
     only during) a DELAY or WAIT command.  A maximum of 32 REPLY commands can
     be active simultaneously. <text1> must not contain carriage returns or
     line feeds. If <text2> is omitted or empty the REPLY command for <text1>
     is cancelled.

     Note:  This command uses a lot of CPU time, therefore you should cancel
     unused replies as soon as you don't need them any more.

     Example:

          /* Wait for 'Command' and

          skip all prompts in between*/

          REPLY Enter ^M

          REPLY More N

          WAIT Command

          REPLY Enter

          REPLY More

     The above example waits until the text Command is received.  While
     waiting, all Enter and More prompts are answered automatically by sending
     ^M.  After the Wait is satisfied, the reply commands are cancelled.

 RESTIMER Reset the timer on the status line.

 SEND <text> Send text to modem.

     Example:

          SEND "JOE USER^M"

 SENDBRK Send a modem break.

 SENDKEY <number> Send text from macro key (1 ... 20).

 SETDLPATH <path> Change the default download directory

     Example:

          SETDLPATH "C:\DOWNLOADS"

 SETEMU 1|2|3 Set emulation (1=ANSI, 2=VT102, 3=TTY).

     Example:

          SETEMU 1

 SETHOST 0|1 Set host echo on or off.

 SETTIMER <hh: mm:ss>Set timer to given time.

 TIMEOUT <sec> Set timeout for WAIT (see also: WAIT, WAITMUX, GETLINE).

     Example:

          TIMEOUT 60

 UPLOAD {A[0|1]|X[K]|Y|Z[A]} <file> Start upload.

     Example:

          UPLOAD XK UPLOADS\ZOC.ZIP
     uploads ZOC.ZIP with Xmodem protocol and 1KB block size.

     Example:

          UPLOAD ZA S:\SOME\REMOTE\PATH\LIST.TXT
      uploads LIST.TXT with via Zmodem (ascii-mode) protocol.

     Example:

          UPLOAD A0 FARAWAY\LIST.TXT
     uploads LIST.TXT with via ascii transfer without CR/LF translation.

 WAIT <text> Wait for the given text (see also: GETLINE, TIMEOUT, WAITMUX). If
     it times out it returns a value of 640 in RC.

     Example:

          WAIT Password

          IF RC=640 THEN SIGNAL PANIC

     Note:  Be careful to wait for text that does not contain ANSI/VT102 codes
     (eg. change of colors).

 WAITMUX <text0> [<text1> ...] Wait for one of multiple texts in the input data
     stream.  It is satisfied if one of the given texts is found in the
     incoming data stream (and is typically used within a loop).  The RC
     variable provides information about which text was found (0, 1, 2 ...) or
     if the command timed out (640).

     Note:  The length of all texts together must not exceed 128 characters.

     Note:  This command uses a lot of CPU time.

     Example:

          'WAITMUX "You have mail" "Main Menu"'

          SELECT

          WHEN RC=0 THEN CALL MAILDOWNLOAD

          WHEN RC=1 THEN LEAVE

          WHEN RC=640 THEN SIGNAL TIMEOUT

          END

 WAITLINE This command is available for compatibility with older versions of
     ZOC. The correct command is now called GETLINE.

 WRITE <text> Write text to screen.

 WRITELN <text> Write text to screen and skip to the next line.

 XFERSHELL <command> Start an external protocol in a Transfer Shell.

     Example:

          GETFILENAME "File to upload"

     Example:

          XFERSHELL "CD \CKERMIT & CKERMIT -l %ZOCHFC% -s" ZOCRESULT()

 XFERDOSSHELL <command> Start an external protocol in a Transfer DOS-Shell.

     Example:

          GETFILENAME "File to upload"

     Example:

          XFERDOSSHELL "C:\DOSCOMM\DSZ\DSZ port 2 sz " ZOCRESULT()

 ----------------------

 ZOCCARRIER() This is a function and returns the current state of the carrier
     detect signal from the modem. If the serial options say that the modem
     provides no valid carrier detect signal it returns N/A, otherwise
     ZOCCARRIER() returns CARRIER or NO CARRIER.

     Example:

          TIMEOUT 30

          WAIT Password

          IF ZOCCARRIER()=="NO CARRIER" THEN SIGNAL PANIC

 ZOCLASTLINE() This is a function and returns the current line of text when the
     last WAIT/WAITMUX/GETLINE command was satisfied.

     Example:

          SEND ATZ^M

          GETLINE

          IF ZOCLASTLINE()==OK THEN DIAL 123456

 ZOCRESULT()This is a function and returns the results from the ASK, REQUEST
     and GETFILENAME commands.

     Example:

          REQUEST я"Are you sure"я Yes No

          IF ZOCRESULT()==Yes THEN SIGNAL DOITAGAIN


ΓòÉΓòÉΓòÉ 8.5. Script Language Commands ΓòÉΓòÉΓòÉ

See the program extract at the end of the list as a prerequisite for the some
of the examples.

 ADD <meta> <num>Add a number to a variable.

     Example:

          ADD VARN 11; WRITELN %VARN%
      => 110

 ASK [<title> [<default>]]Read text input from user. Result in %lastline%.

     Example:

          ASK "Are You sure?"

 BAUD <baud>[-{7|8}{N|O|E}{1|2}]Set serial parameters.

     Example:

          BAUD 4800-8N1

 BEEP [<n>]Beep n times

 CALL <label>Call a label (defined as ':label') as subroutine (see also:
     RETURN).

     Example:

          CALL Label

 CAPTCLRClear the capture buffer

 CLOSEFILEClose the file opened with OPENFILE

 CLS Clear the screen

 COMPA <string> WITH <string>Compare two ASCII strings (see also: EXACT, IFxxx)

     Example:

          COMPA "%VAR1%" WITH "%VAR2%"

 COMPN <num> WITH <num>Compare numeric values

 DEBUG 0|1Debugmode off/on

 DEC <meta>Decrement numeric variable by one.

     Example:

          DEC VARN

 DELAY [<sec>]Wait given time in seconds or delay 1/5 second if parameter is
     omitted.

 DIAL [<number>]Dial a number or display dial requester.

 DIV <meta> <num>Divide a variable by a number

 DOWNLOAD {X[C]|Y|Z} <file>Download file with X/Y/Zmodem (Zmodem can be done
     with the ZOC's autodownload feature as well).

 ENDSCRIPTSame as EXIT

 ENDZOCTerminate ZOC and return to shell or WPS

 EXACT 0|1Set exact mode for COMPA. EXACT 1 means, that the two strings must be
     exactly equal. EXACT 0 means, that the are compared in the length of the
     shorter string (that is, line [6] in the example below would result to
     equal).

 EXITEnd the script

 EXTERN <scriptfile> [<parameter>]Execute other scriptfile. The other
     scriptfile gets the parameter in the %lastline% variable.

 GETENV <name>Read value from environment into %lastline%.

 GETFILERead line from ASCII file opened with OPENFILE into %lastline%

 GETFILENAME <title>Display a file requester and return name in %lastline%

 GETLINEWait for the next non empty line of text from the modem (use WAIT "^M"
     to wait for the next line, no matter if empty or not). (See WAIT, TIMEOUT,
     IFBRK, IFNBRK).

     Example:

          GETLINE

 GOTO <label>Jump to label (defined as ':label')

 HANGUPDisconnect from line

 IFBRK <command>Do command if the last WAIT/GETLINE returned due to timeout.

     Example:

          IFBRK GOTO ERROR

 IFEQU <command>Do command if the operands of the last COMPx (COMPA/COMPN) were
     equal.

     Example:

          IFEQU SETN X 0

 IFHIGH <command>Do command if first operand of the last COMPx was greater than
     the second.

     Example:

          IFHIGH SEND "^X^X^X^X"

 IFIN <command>Do command if first operand of the last COMPA was found
     somewhere in the second.

 IFLOW <command>Do command if first operand of the last COMPx was lower than
     the second.

 IFNBRK <command>Do command if the last WAIT/GETLINE returned with the text
     found.

 IFNEQU <command>Do command if result from last COMPx was not equal.

 IFNHIGH <command>Do command if first operand of the last COMPx was lower than
     or equal to the second.

 IFNIN <command>Do command if first operand of the last COMPA was not

 IFNLOW <command>Do command if first operand of the last COMPx was greater than
     or equal to the second.

 INC <meta>Increment numerical variable by one.

     Example:

          INC VARN

 KILL <meta>Remove variable from memory (not explicitly necessary).

     Example:

          KILL VARN

 LOADOPTS <optsfile>Load options file.

     Example:

          LOADOPTS "OPTIONS\VT102OPT"

 LOGNAME <filename>Set new name for logging.

     Example:

          LOGNAME "TODAY.LOG"

 LOGGING [0|1]Suspend/resume logging

 LOWER <meta>Convert value of variable to lowercase (see also: UPPER).

     Example:

          LOWER VAR1

 LTRIM <meta>Remove blanks from beginning of variable (see also: RTRIM).

     Example:

          LTRIM VAR1

 MAXSCAN <num>Set maximum recursion for meta replacement. Variables can contain
     references to other variables (e.g. SETA V1 "%%V2%%", SETA V2 "%%V3%%",
     SETA V3 "Hello World"). MAXSCAN defines the maximum scanning depth for
     such value expansions. That is, normally "%V1%" would expand to "Hello
     World", while it would expand to "%V2%" if MAXSCAN were '1'.

 META <newchar>Change meta character "%" into something else.

     Example:

          META $; WRITELN "$VAR1$"

 MOD <meta> <num>Calculate result of meta mod num and store result in the
     variable of the first argument.

     Example:

          MOD VARN 10; WRITELN %VARN%
      => 9

 MUL <meta> <num>Multiply a variable with a number and store result in the
     variable of the first argument.

     Example:

          MUL VARN 100; WRITELN %VARN%
      => 9900

 NOTIFY <text>Display message window.

     Example:

          NOTIFY "Hello World!"

 OPENFILE <filename> <mode>Open ASCII file (mode= r,w,a).

     Example:

          OPENFILE "data.lst" "a"
     opens file 'data.lst' in write append mode.

 PRINT <text>Same as WRITELN

 PUTFILE <text>Write text to an ASCII file opened with OPENFILE

 QUOTE <newquote>Change quotation character (")

 REQUEST <title> <opt1> [<opt2> [<opt3]]Display requester with options.

     Example:

          REQUEST "Are you sure?" "Yes" "No"

 RESPOND <text1> <text2>Send <text2> if <text1> is received (only during DELAY
     or WAIT commands). A maximum of 32 RESPOND commands can be active
     simultaneously. <text1> must not contain carriage returns or line feeds.
     RESPOND <text1> "" cancells any previous RESPOND commands for <text1>.

 RESTIMERReset the timer on the status line.

 RETURNReturn from subroutine call (see also: CALL)

 RTRIM <meta>Remove trailing blanks from variable (see also: LTRIM).

     Example:

          RTRIM VAR1

 SEND <text>Send text to modem.

     Example:

          SEND "JOE USER^M"

 SENDBRKSend a modem break

 SENDKEY <number>Send text from macro key (1 ... 20)

 SETA <meta> <text> [<pos> [<length>]]Create or overwrite ASCII variable with
     text. Positive <pos> is counted from the left side of <text>, negative
     <pos> is taken from the right.

     Example:


             SETA V1 "Hello World"
             SETA V2 "Hello World" +4
             SETA V3 "Hello World" -3
             SETA V4 "Hello World" +2 3
             WRITE "%V1%, %V2%, %V3%, %V4%"

     OUTPUT: Hello World, lo World, rld, llo.

 SETN <meta> <num>Create or overwrite numerical variable with value

 SETEMU 1|2|3Set emulation (1=ANSI, 2=VT102, 3=TTY).

     Example:

          SETEMU 1

 SETHOST 0|1Set host echo on or off

 SETTIMER <hh:mm:ss>Set timer to given time

 SHELL <command>Execute a program via 'CMD.EXE /C <command>'.

     Example:

          SHELL "DEL FILE.TMP"

 SUB <meta> <num>Subtract a number from a variable.

     Example:

          SUB VARN 50; WRITELN %VARN%
      => 49

 TIMEOUT <sec>Set timeout for WAIT (see also: WAIT, GETLINE, IFBRK, IFNBRK).

     Example:

          TIMEOUT 60

 UPLOAD {A[0|1]|X[K]|Y|Z} <file>Start upload.

     Example:

          UPLOAD XK "ZOC.ZIP"
     uploads ZOC.ZIP with Xmodem protocol and 1K blocksize.

     Example:

          UPLOAD A0 "LIST.TXT"
     uploads LIST.TXT with per ascii transfer without CR/LF translation.

 UPPER <meta>Convert variable to uppercase (see also: LOWER)

 WAIT <text>Wait for the given text (see also: GETLINE, TIMEOUT, IFBRK, IFNBRK)

     Example:

          WAIT "Password"

 WAITLINEThis command is available for compatibility with older versions of
     ZOC. The correct command now is GETLINE.

 WRITE <text>Write text to screen

 WRITELN <text>Write text to screen, add newline

 XFERSHELL <command>Start an external protocol in an Transfer Shell.

     Example:

          GETFILENAME "File to upload"

     Example:

          XFERSHELL "CD \CKERMIT & CKERMIT -l %ZOCHFC% -s" %lastline%

 XFERDOSSHELL <command>Start an external protocol in an Transfer DOS-Shell.

     Example:

          GETFILENAME "File to upload"

     Example:

          XFERSHELL "DSZ port 2 -sz " %lastline%

 Note:Many functions (such as OPENFILE, REQUEST, GETFILE deliver error codes
     like (##ERROR##, ##CANCEL##, ##EOF##, ...) in %lastline%.

 Program part for the examples

             SETA VAR1 "Hello  "
             SETA VAR2 "Hell"
             SETN VARN 99
             SETN VARN2 10
          :Label
             WRITELN "%VAR1%"
             COMPA "%VAR1%" WITH "%VAR2%"
             COMPA  %VARN% WITH 100
             COMPN  %VARN% WITH %VARN2%


ΓòÉΓòÉΓòÉ 8.6. Contacting the author ΓòÉΓòÉΓòÉ

 I more or less monitor international conferences and forums (mainly OS2 and
OS2.GER on FIDO's, comp.os.os2.apps on the Internet and OS2SHARE on
CompuServe).

If you have problems, feel free to contact me personally (PLEASE check the help
file, especially the Problems and Questions section and the contents of the
file PROBLEMS.DOC, first).

E-Mail (preferred):

     Internet
    [e-mail] or [e-mail] (please no mail >5KB to
    the second address!)

     CompuServe
    100101,3256

 ZOC Infobbs
    The number is [phone] (or 0911 9933662 from Germany). Login as
    'ZOC'. The menus there are in English!

Other:

     Phone
    +49+911+7406856 (or 0911 7406856 from within Germany).

     FAX
    +49+911+7406857 (or 0911 7406857 from within Germany).

 Mail

         EmTec
         Markus Schmidt
         Waagstr. 4
         90762 Fuerth
         - Germany -


ΓòÉΓòÉΓòÉ 8.7. Common problems (trouble shooting guide) ΓòÉΓòÉΓòÉ

Please check the PROBLEMS.DOC file for possible problems and solutions as well.

 Where do I get the current version of ZOC?

    BMT Micro
       [phone] [10 lines, 14.4K] or [phone] [28.8K], login with
       your own name or FIDO FREQ magic ZOCBETA 1:3628/11

           CompuServe
       OS2SHARE forum, library 1

           FTP
       ftp.demon.co.uk /pub/os2/comm/zoc

    Software Solutions
       [phone], name ZOC, password SUPREME

    Virtual Reality BBS
       [phone], login as GUEST

    ZOC Info-BBS
       [phone], login as ZOC

 How can I set ZOC to tone dial
    Change the modem options and set the dialing command to 'ATDT'.

 My modem works properly with other terminal software but not with ZOC
    Try using the same modem initialization as in the other terminal package.
    Or store that modem configuration into the non-volatile memory of the modem
    (mostly done with AT&W) and use ATZ as the initialization string for ZOC.

 Error SYS3175 when starting a shell or editor from ZOC
    Please try to delete (or REM out) some SET commands in your CONFIG.SYS,
    reboot and try again.

 ZOC increases calls and phone cost for several phone book entries at a time
    This is a feature to maintain multi phone port BBSs.  Details are described
    in editing phone book entries.

 No characters appear after making a connection
    You use a secured transmission and the modem waits to get an OK signal from
    the computer which does not come. Turn on RTS/CTS in Options, Serial.

 Zmodem uploads to Unix-RZ do not start at all or fail
    Try to use the -e, -eb or -v option on Unix's side: rz -e, rz -eb  or rz -v

    If your connection is routed through a Xyplex concentrator, there currently
    is no known method to make Zmodem uploads at all.  You will have to use
    another protocol -- best choice in this case is probably CKERMIT used from
    a transfer shell from ZOC (please search this help file for CKERMIT to get
    details).

 Downloads generally work fine, but uploads of large files fail
    Probably you are using a high-speed modem but have RTS/CTS disabled. For
    high-speed transmission both, the modem and ZOC, need to be configured to
    use RTS/CTS handshaking.

 The text 'CIS-B ENQ received' appears during a session
    Your host is sending a code that CompuServe normally uses to initiate file
    transfers. Go to the Transfer, Plugs menu and disable the enquiry in the
    CompuServe-B+ setup.  If this problem occurs during CompuServe login, go to
    the CompuServe setup and disable the item 'Micro Inquiry'.

 The cursor keys do not work in some VT102 applications
    You should use the gray cursor keys, not the numeric keypad.  The keypad is
    used for other purposes by these applications.

 Sometimes the keyboard quits working while the mouse still works ok
    Probably one of the qualifier keys (alt/ctrl/shift) got stuck.  Pressing
    all these keys once usually helps.

 The STANDARD options are not used at startup
    Maybe you unpacked ZOC without preserving pathnames.  The STANDARD file
    must be in a subdirectory named OPTIONS (and located in your ZOC directory,
    e.g. C:\TERM\ZOC\OPTIONS).

 Whenever I leave the program I get a Carrier Detect warning
    Maybe your modem is configured to have the CD signal always on.  Set it to
    match the CD state (maybe AT&C1) or set the CD signal to 'invalid' in the
    serial options.

 The phone book does not load the options file
    You need to enter the path as well as the options file name, e.g.
    OPTIONS\VTOPTS.

 Sizing the ZOC only works in large steps
    By default ZOC changes the font size when you size the window.  Since the
    font is not available in every necessary size ZOC will use a best-fit
    method and size the window accordingly.  If you do not like this, you can
    change the sizing behavior in the Window Options.

 I miss a full screen mode
    There is no character based full screen mode available.  ZOC is a true PM
    program and uses the benefits of OS/2's window system (like offering
    icons). However, you can maximize the ZOC window using the maximize button
    in the title bar.  This way ZOC will cover the whole screen (you should
    select a large font if you do this).

 Scrolling is slow
    Scrolling in an WPS window is generally slower that in full screen mode.
    There is a scroll speed option in options->window.

 Is there a way to change the font or the colors of the terminal window?
    You can change the font size and color of the terminal window in
    options->window, but not the font.

 After downloads the time setting of files is off by a few hours
    Please check the discussion of the TZ environment variable in the starter
    section of this file or set the 'Ignore time stamp' option in Transfer
    Options.

 What does ZOC mean?
    The Hitchhikers Guide to the Galaxy might describe ZOC as followed:

     zoc (v), to zoc means communicating with other people through the means of
    extremely sophisticated hard- and software (sophisticated at least from the
    viewpoint of the ape-descended inhabitants of an extremely unimportant blue
    planet in an even lesser important part of the galaxy who think that
    W*****s is a pretty neat piece of software).


ΓòÉΓòÉΓòÉ 8.8. Credits ΓòÉΓòÉΓòÉ

We would like to thank

 Frank Burleigh for innumerous suggestions/improvements regarding the help text
and the program.  Hans-Juergen Rauscher for writing ZOCBK.  Jay Sottolano for
his encouragement in the very early stages of the program.  Jim Himmelman for
his support on the FIDO network.  John McNamara for running the help file
through the spell checker twice.  Nicole Greiber for proofreading the help
file.  Rod Smith for his support on the usenet during the 911-affair and later.
Richard Ashton for his support on the FIDO net during the 911-affair.  Tom
Hansen and  Jim LaSalle for downloading ZOC from Germany to help me to find the
Cirrus driver workaround.

Not to forget all the people who's names got lost in a hard disk havoc who
helped ZOC to become a success through their innumerous bug reports and
suggestions via email and fax.

And thanks to  Douglas Adams,  Richard Bach,  Jane Roberts,  Brian Eno,  Frank
Zappa,  Igor Stravinsky,  Philip Glass,  Barbra Streisand,  Jim Steinman and
Meat Loaf,  Chivas Brother Ltd,  Pizzeria Rimini and several  Ceylonese Tea
Producers for caring about our mental and physical needs.

Last but not least, thanks to IBM for creating the best PC operating system in
the world.

Markus Schmidt
Markus GФmmel